NAME

sec_rgy_pgo_delete_member — Removes a member from a group or organization

Synopsis

void sec_rgy_pgo_delete_member(
sec_rgy_handle_t context,
sec_rgy_domain_t name_domain,
sec_rgy_name_t go_name,
sec_rgy_name_t principal_name,
error_status_t ∗status);

Parameters

Input

contextAn opaque handle bound to a registry server.  Use sec_rgy_site_open() to acquire a bound handle. 

name_domain
This variable identifies the type of the principal, group, or organization (PGO) item identified by the given name.  The valid values are as follows:

sec_rgy_domain_group
The go_name parameter identifies a group. 

sec_rgy_domain_org
The go_name parameter identifies an organization. 

go_nameA character string (type sec_rgy_name_t) containing the name of the group or organization from which the specified principal will be removed. 

principal_name
A character string (type sec_rgy_name_t) containing the name of the principal to be removed from the membership list of the group or organization specified by go_name. You must use fully-qualified names to remove foreign principals from groups.  (Only local principals can be members of an organization.) 

Output

statusA pointer to the completion status.  On successful completion, the routine returns error_status_ok.  Otherwise, it returns an error. 

Description

The sec_rgy_pgo_delete_member() routine removes a member from the membership list of a group or organization.   The principal to be removed from a group can be in the local or a foreign cell.  (Only local principals can be members of an organization.) 

Permissions Required

The sec_rgy_pgo_delete_member() routine requires the M (Member_list) permission on the group or organization item specified by go_name. 

Files

/usr/include/dce/pgo.idl
The idl file from which dce/pgo.h was derived. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

sec_rgy_not_authorized
The client program is not authorized to remove the specified member.

sec_rgy_bad_domain
An invalid domain was specified.  Members can exist only for groups and organizations, not for principals.

sec_rgy_object_not_found
The specified group or organization was not found.

sec_rgy_server_unavailable
The DCE registry server is unavailable.

error_status_ok
The call was successful.

Related Information

Functions: sec_intro(3sec), sec_rgy_pgo_add(3sec), sec_rgy_pgo_add_member.