Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

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:

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

/usr/include/dce/acct.idl

The idl file from which dce/acct.h was derived.

ERRORS

error_status_ok

The call was successful.

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.

SEE ALSO

Functions: sec_rgy_acct_add(), sec_rgy_pgo_delete().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index