sec_rgy_acct_rename-Changes an account login name
#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);
An opaque handle bound to a registry server. Use sec_rgy_site_open() to acquire a bound handle.
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.
A pointer to the new account login name. Again, all three component names must be completely specified.
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.
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.
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 RequiredThe sec_rgy_acct_rename() routine requires the m (mgmt_info) permission on the account principal to be renamed.
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).
The idl file from which dce/acct.h was derived.
The call was successful.
The client program is not authorized to make the changes.
The account to be modified was not found by the registry server.
The new account name is already in use by another account.
The DCE Registry Server is unavailable.