sec_rgy_acct_delete-Deletes an account
#include <dce/acct.h> void sec_rgy_acct_delete( sec_rgy_handle_t context, sec_rgy_login_name_t *login_name, 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 account login name. A login name is composed of three character strings, containing the principal, group, and organization (PGO) names corresponding to the account. Only the principal name is required to perform the deletion.
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.
The sec_rgy_acct_delete() routine deletes from the registry the account corresponding to the specified login name.
Permissions RequiredThe sec_rgy_acct_delete() routine requires the following permissions on the account principal:
- The m (mgmt_info) permission to remove management information.
- The a (auth_info) permission to remove authentication information.
- The u (user_info) permission to remove user information.
Even though the account is deleted, the PGO items corresponding to the account remain. These must be deleted with separate calls to sec_rgy_pgo_delete().
The idl file from which dce/acct.h was derived.
The call was successful.
The client program is not authorized to delete the specified account.
No PGO item was found with the given name.
The DCE Registry Server is unavailable.