HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_get_init_creds_password — Get the initial credentials password

  Table of Contents

  Glossary

  Index

C Prototype

krb5_error_code krb5_get_init_creds_password (
krb5_context context,
krb5_creds *creds,
krb5_principal client,
char *password,
krb5_prompter_fct prompter,
void *data,
krb5_deltat start_time,
char *in_tkt_service,
krb5_get_init_creds_opt *options );

Arguments

context (input/output) 

The context structure.

creds (output) 

A pointer to a Kerberos credentials structure.

client (input) 

The client principal.

password (input/output) 

The password associated with the initial credentials.

prompter (input) 

A pointer to a password prompt routine.

data (input) 

The data for the password prompt routine.

start_time (input) 

The time that the credentials first become valid.

in_tkt_service (input) 

A pointer to the output buffer containing the TGT.

options (input) 

A pointer to a structure containing flags and options.

Description

This routine acquires the password associated with the initial credentials.

Return Values

This routine returns the following KRB5 status codes:

None.Successful completion.

EINVAL

Invalid argument.

KRB5_KDC_UNREACH

Cannot contact any KDC for requested realm.

KRB5_PREAUTH_FAILED

Generic preauthentication failure.

KRB5_LIBOS_PWDINTR

Password read interrupted.

KRB5_REALM_CANT_RESOLVE

Cannot resolve network address for KDC in requested realm.

KRB5KDC_ERR_KEY_EXP

Password has expired.

KRB5_LIBOS_BADPWDMATCH

Password mismatch.

KRB5_CHPW_PWDNULL

ew password cannot be zero length.

KRB5_CHPW_FAIL

Password change failed.