krb5_set_password_using_ccache - Set a password for a principal using cached credentials. — MIT Kerberos Documentation

# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_set_password_using_ccache - Set a password for a principal using cached credentials.

krb5_error_code krb5_set_password_using_ccache(krb5_context context, krb5_ccache ccache, 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] ccache - Credential cache

  [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

return:

  - Kerberos error codes

This function uses the cached credentials from ccache to set the password newpw for the principal change_password_for . It implements RFC 3244 set password operation (interoperable with MS Windows implementations) using the credential cache.

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

Note

If change_password_for is set to NULL, the change is performed on the default principal in ccache . If change_password_for is nonnull, the change is performed on the specified principal.