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

..

.. c:function:: 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* .
 



