# 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 .