HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

541

542

543

544

545

546

547

548

549

550

gss_test_oid_set_member(3) gss_test_oid_set_member(3)

NAME

gss_test_oid_set_member() - check an OID set for a speciﬁed OID

SYNOPSIS

#include <gssapi.h>

OM_uint32 gss_test_oid_set_member (

OM_uint32 *minor_status,

const gss_OID member_OID,

const gss_OID_set set,

int* is_present /* 1 = present, 0 = absent */ );

DESCRIPTION

The gss_test_oid_set_member()

routine checks an OID set to see if the speciﬁed OID is a member

of the set. To add a member to an OID set, use the

gss_add_oid_set_member()

routine.

The

gss_test_oid_set_member()

routine uses the value of the actual_mechs output parameter

from the

gss_acquire_cred()

routine to get the list of OIDs. It checks this list to see if any of the

OIDs are members of the OID set. This routine is intended to be used with OID sets returned by

gss_indicate_mechs()

, gss_acquire_cred()

, and

gss_inquire_cred()

Input Parameters

member_OID Speciﬁes the OID to search for in the OID set.

set Speciﬁes the OID set to check.

Output Parameters

is_present Returns one of the following values to indicate whether the OID is a member of

the OID set:

1 If the OID is present as a member of the OID set.

0 If the OID is absent, not a member of the OID set.

minor_status Returns a status code from the security mechanism.

STATUS CODES

The following status codes can be returned:

GSS_S_COMPLETE The routine was completed successfully.

GSS_S_FAILURE The routine failed. Check the minor_status parameter for details.

AUTHOR

gss_test_oid_set_member()

was developed by Sun Microsystems, Inc.