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

 NAME
   sec_rgy_pgo_delete_member - Deletes a member of a group or organization

 SYNOPSIS

   #include <dce/pgo.h>

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

   name_domain
          This variable identifies the type of the person, 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_name
          A character string (type sec_rgy_name_t) containing the name
          of the group or organization from which the specified person
          will be deleted.

   person_name
          A character string (type sec_rgy_name_t) containing the name
          of the person to be deleted from the membership list of the
          group or organization specified by go_name.

   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_pgo_delete_member() routine deletes a member from the
   membership list of a group or organization. Any accounts in which
   the person holds the deleted group or organization membership are
   also deleted.

   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

   SYS$COMMON:[DCE$LIBRARY]PGO.IDL
                  The idl file from which dce/pgo.h was derived.

 ERRORS

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

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

   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
              sec_rgy_pgo_add
              sec_rgy_pgo_add_member