gss_test_oid_set_member(3)                       gss_test_oid_set_member(3)




 NAME    [Toc]    [Back]
      gss_test_oid_set_member() - check an OID set for a specified OID

 SYNOPSIS    [Toc]    [Back]
      #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    [Toc]    [Back]
      The gss_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 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    [Toc]    [Back]
      member_OID            Specifies the OID to search for in the OID set.

      set                   Specifies the OID set to check.

    Output Parameters    [Toc]    [Back]
      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    [Toc]    [Back]
      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.





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 gss_test_oid_set_member(3)                       gss_test_oid_set_member(3)




 AUTHOR    [Toc]    [Back]
      gss_test_oid_set_member() was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]
      gss_add_oid_set_member(3), gss_acquire_cred(3), gss_indicate_mechs(3).

      The manpages for DCE-GSSAPI are included with the DCE-CoreTools
      product.  To see those manpages add /opt/dce/share/man to MANPATH.


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003