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

 NAME
   sec_rgy_acct_rename - Changes an account login name

 SYNOPSIS

   #include <dce/acct.h>

   void sec_rgy_acct_rename(
           sec_rgy_handle_t context,
           sec_rgy_login_name_t *old_login_name,
           sec_rgy_login_name_t *new_login_name,
           sec_rgy_acct_key_t *new_key_parts,
           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.

   old_login_name
          A pointer to the current account login name.  The 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.

   new_login_name
          A pointer to the new account login name. Again, all three
          component names must be completely specified.

   Input/Output

   new_key_parts
          A pointer to the minimum abbreviation allowed when logging in
          to the account. Abbreviations are not currently implemented and
          the only legal value is sec_rgy_acct_key_person.

   Output

   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_rename() routine changes an account login name from
   old_login_name to new_login_name. Wildcards (empty fields) are not
   permitted in either input name; both the old and new login names must
   completely specify their component principal, group, and organization
   names.  Note, though, that the principal component in a login name
   cannot be changed.

   The new_key_parts variable identifies how many of the new_login_name
   parts to use as the unique abbreviation for the account.  If the
   requested abbreviation duplicates an existing abbreviation for another
   account, the routine identifies the next shortest unique abbreviation
   and returns this abbreviation using new_key_parts.

   Permissions Required

   The sec_rgy_acct_rename() routine requires the m (mgmt_info)
   permission on the account principal to be renamed.

 NOTES

   The sec_rgy_acct_rename() routine does not affect any of the registry
   PGO data. The constituent principal, group, and organization items
   for an account must be added before the account can be created.
   (See the sec_rgy_pgo_add routine).  Also, the principal must have
   been added as a member of the specified group and organization.
   (See the sec_rgy_pgo_add_member routine).

 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 make the changes.

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

   sec_rgy_name_exists
                The new account name is already in use by another account.

   sec_rgy_server_unavailable
                The DCE Registry Server is unavailable.

   error_status_ok
                The call was successful.

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_acct_add