| ## sec_rgy_acct_passwd(3sec) Changes the password for an account Synopsis #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); Parameters Input context An 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_key The key to use to encrypt the key for transmission to the registry server. new_key The 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. status A 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) ##