VMS Help DCE_SECURITY, API Routines, sec_rgy_acct_passwd  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   sec_rgy_acct_passwd - 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
          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.

   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

   SYS$COMMON:[DCE$LIBRARY]ACCT.IDL
                The idl file from which dce/acct.h was derived.

 ERRORS

   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