# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_change_password - Change a password for an existing Kerberos account.

krb5_error_code `krb5_change_password`(krb5_context context, krb5_creds * creds, const char * newpw, int * result_code, krb5_data * result_code_string, krb5_data * result_string)

param: | [in] context - Library context [in] creds - Credentials for kadmin/changepw service [in] newpw - New password [out] result_code - Numeric error code from server [out] result_code_string - String equivalent to result_code [out] result_string - Change password response from the KDC

retval: | 0 Success; otherwise - Kerberos error codes

Change the password for the existing principal identified by creds .

The possible values of the output result_code are:

> - `KRB5_KPASSWD_SUCCESS` (0) - success
> - `KRB5_KPASSWD_MALFORMED` (1) - Malformed request error
> - `KRB5_KPASSWD_HARDERROR` (2) - Server error
> - `KRB5_KPASSWD_AUTHERROR` (3) - Authentication error
> - `KRB5_KPASSWD_SOFTERROR` (4) - Password change rejected