HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming
Interface
krb5_set_password_using_ccache — Implements RFC 3244 set password using credentials cache
C Prototype | |
krb5_error_code krb5_set_password_using_rcache ( krb5_context context, krb5_ccache ccache, char *newpw, krb5_principal change_password_for, int *result_code, krb5_data *result_code_string, krb5_data *result_string );
|
Arguments | |
context
(input/output) | | The context structure. | ccache (input) | | The Kerberos credentials
cache. | newpw (input) | | The new password to be set. | change_password_for (input) | | The principal for which the
password change is to be performed. If NULL, the change is to be
done on the current principal. If nonNULL, the change is preformed
on the principal name passed in change_password_for. | result_code (output) | | A pointer to the result code
returned from the remote system. | result_code_string (output) | | A pointer to the result code
translated into a readable message. | result_string (output) | | A pointer to the result data
returned from the remote system. |
Description | |
This routine allows a new password to be set in a manner that
is interoperable with Windows implementations per RFC 3244. This
routine uses the credentials cache instead of explicitly passed credentials
(which are used in krb5_set_password). Return
Values | |
This routine returns the following KRB5 status codes: 0 | Successful completion. | INVALID_SOCKET | Invalid socket. | ECONNREFUSED | Connection refused. | EHOSTUNREACH | Host unreachable. | ECONNABORTED | Connection aborted. | ETIMEDOUT | Connection timed out. | ENOMEM | Insufficient memory. |
|