sec_rgy_acct_passwd-Changes the password for an account
#include <dce/acct.h> void sec_rgy_acct_passwd( sec_rgy_handle_t context, sec_rgy_login_name_t *login_name, sec_passwd_rec_t *caller_key, sec_passwd_rec_t *new_key, sec_passwd_type_t new_keytype, sec_passwd_version_t *new_key_version, error_status_t *status);
An opaque handle bound to a registry server. Use sec_rgy_site_open() to acquire a bound handle.
A pointer to the account login name. A login name is composed of three character strings, containing the principal, group, and organization (PGO) names corresponding to the account. All three strings must be completely specified.
A key to use to encrypt the key for transmission to the registry server. If communications secure to the rpc_c_authn_level_pkt_privacy level are available on a system, then this parameter is not necessary, and the packet encryption is sufficient to ensure security.
The password for the new account. During transmission to the registry server, it is encrypted with caller_key.
The type of the new key. The server uses this parameter to decide how to encode new_key if it is sent as plain text.
The key version number returned by the server. If the client requests a particular key version number (via the version_number field of the new_key input parameter), the server returns the requested version number back to the client.
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.
The sec_rgy_acct_passwd() routine changes an account password to the input password character string. Wildcards (blank fields) are not permitted in the specified account name; the principal, group, and organization names of the account must be completely specified.
Permissions RequiredThe sec_rgy_acct_passwd() routine requires the u (user_info) permission on the account principal whose password is to be changed.
The idl file from which dce/acct.h was derived.
The call was successful.
The client program is not authorized to change the password of this account.
The account to be modified was not found by the registry server.
The DCE Registry Server is unavailable.