NAME

sec_rgy_acct_passwd — Changes the password for an account

Synopsis

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);

Parameters

Input

contextAn opaque handle bound to a registry server.  Use sec_rgy_site_open() to acquire a bound handle. 

login_name
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.

caller_keyThe key to use to encrypt the key for transmission to the registry server. 

new_keyThe password for the new account.  During transmission to the registry server, it is encrypted with caller_key. 

new_keytype
The type of the new key.  The server uses this parameter to decide how to encode new_key if it is sent as plaintext. 

Output

new_key_version
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. 

statusA pointer to the completion status.  On successful completion, the routine returns error_status_ok.  Otherwise, it returns an error. 

Description

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 Required

The sec_rgy_acct_passwd() routine requires the u (user_info) permission on the account principal whose password is to be changed. 

Files

/usr/include/dce/acct.idl
The idl file from which dce/acct.h was derived. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

sec_rgy_not_authorized
The client program is not authorized to change the password of this account.

sec_rgy_object_not_found
The account to be modified was not found by the registry server.

sec_rgy_server_unavailable
The DCE registry server is unavailable.

error_status_ok
The call was successful.

Related Information

Functions: sec_intro(3sec).