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

 NAME
   sec_rgy_acct_delete - Deletes an account

 SYNOPSIS

   #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);

 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.
             Only the principal name is required to perform the deletion.

   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_delete() routine deletes from the registry the account
   corresponding to the specified login name.

   Permissions Required

   The 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.

 NOTES

   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().

 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 delete the
                specified account.

   sec_rgy_object_not_found
                No PGO item was found with the given name.

   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
              sec_rgy_pgo_delete