# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_set_password - Set a password for a principal using specified credentials.

krb5_error_code `krb5_set_password`(krb5_context context, krb5_creds * creds, const char * newpw, krb5_principal change_password_for, 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 [in] change_password_for - Change the password for this principal [out] result_code - Numeric error code from server [out] result_code_string - String equivalent to result_code [out] result_string - Data returned from the remote system

retval: | 0 Success and result_code is set to KRB5_KPASSWD_SUCCESS .
return: | Kerberos error codes.

This function uses the credentials creds to set the password newpw for the principal change_password_for . It implements the set password operation of RFC 3244, for interoperability with Microsoft Windows implementations.

The error code and strings are returned in result_code , result_code_string and result_string .

Note

If change_password_for is NULL, the change is performed on the current principal. If change_password_for is non-null, the change is performed on the principal name passed in change_password_for .