aboutsummaryrefslogtreecommitdiff
path: root/doc/html/_sources/appdev/refs/api/krb5_set_password.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/html/_sources/appdev/refs/api/krb5_set_password.txt')
-rw-r--r--doc/html/_sources/appdev/refs/api/krb5_set_password.txt74
1 files changed, 74 insertions, 0 deletions
diff --git a/doc/html/_sources/appdev/refs/api/krb5_set_password.txt b/doc/html/_sources/appdev/refs/api/krb5_set_password.txt
new file mode 100644
index 000000000000..0fefb2cea3e2
--- /dev/null
+++ b/doc/html/_sources/appdev/refs/api/krb5_set_password.txt
@@ -0,0 +1,74 @@
+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* .
+
+
+
+