PreviousNext

gssdce_test_oid_set_member(3sec)

Checks an OID set to see if a specified OID is in the set

Synopsis

#include <dce/gssapi.h>

OM_uint32 gssdce_test_oid_set_member (
OM_uint32 *minor_status,
gss_OID member_OID,
gss_OID_set
set,
int*
is_present /* 1 = present, 0 = absent */ );

Parameters

Input

member_OID
Specifies the OID to search for in the OID set.

set
Specifies the OID set to check.

Output

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

Returns... If...
1 The OID is present as a member of the OID set
0 The OID is absent, not a member of the OID set
minor_status
Returns a status code from the security mechanism.

Description
The gssdce_test_oid_set_member( ) routine checks an OID set to see if the specified OID is a member of the set. To add a member to an OID set, use the gssdce_add_oid_set_member( ) routine.

The gssdce_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.

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.

GSS_S_COMPLETE The routine was completed successfully.
GSS_S_FAILURE The routine failed. Check the minor_status parameter for details.
Related Information
Functions:

gssdce_add_oid_set_member(3sec)

gss_acquire_cred(3sec)

gss_indicate_mechs(3sec)