1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
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* .
|
