Previous section.

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

NAME

sec_rgy_pgo_is_member-Checks group or organization membership

SYNOPSIS

#include <dce/pgo.h>

boolean32 sec_rgy_pgo_is_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 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_name

A character string (type sec_rgy_name_t) containing the name of the group or organization whose membership list is in question.

person_name

A character string (type sec_rgy_name_t) containing the name of the principal whose membership in the group or organization specified by go_name is in question.

Output

status

A pointer to the completion status. On successful completion, status is assigned error_status_ok. Otherwise, it returns an error.

DESCRIPTION

The sec_rgy_pgo_is_member() routine tests whether the specified principal is a member of the named group or organization.


Permissions Required

The sec_rgy_pgo_is_member() routine requires the t (test) permission on the group or organization item specified by go_name.

RETURN VALUES

The routine returns TRUE if the principal is a member of the named group or organization. If the principal is not a member, the routine returns FALSE.

FILES

/usr/include/dce/pgo.idl

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

ERRORS

error_status_ok

The call was successful.

sec_rgy_object_not_found

The named group or organization was not found.

sec_rgy_server_unavailable

The DCE Registry Server is unavailable.

SEE ALSO

Functions: sec_rgy_pgo_add_member(), sec_rgy_pgo_get_members().
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