Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Generic Security Services API Library Functionsgss_add_oid_set_member(3GSS)


NAME

 gss_add_oid_set_member - add an object identifier to an object identifier set

SYNOPSIS

 
cc -flag ...  file ...-lgss [library ...] 
#include <gssapi/gssapi.h>
OM_uint32 gss_add_oid_set_member(OM_uint32 *minor_status, const gss_OID member_oid, gss_OID_set *oid_set);

DESCRIPTION

 

The gss_add_oid_set_member() function adds an object identifier to an object identifier set. You should use this function in conjunction with gss_create_empty_oid_set(3GSS) when constructing a set of mechanism OIDs for input to gss_acquire_cred(3GSS). The oid_set parameter must refer to an OID-set created by GSS-API, that is, a set returned by gss_create_empty_oid_set(3GSS).

The GSS-API creates a copy of the member_oid and inserts this copy into the set, expanding the storage allocated to the OID-set elements array, if necessary. The function may add the new member OID anywhere within the elements array, and the GSS-API verifies that the new member_oid is not already contained within the elements array. If the member_oid is already present, the oid_set should remain unchanged.

PARAMETERS

 

The parameter descriptions for gss_add_oid_set_member() follow:

minor_status
A mechanism specific status code.
member_oid
Object identifier to be copied into the set.
oid_set
Set in which the object identifier should be inserted.

RETURN VALUES

 

The gss_add_oid_set_member() function may return the following status codes:

GSS_S_COMPLETE
Successful completion.
GSS_S_FAILURE
The underlying mechanism detected an error for which no specific GSS status code is defined. The mechanism-specific status code reported by means of the minor_status parameter details the error condition.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWgss (32-bit)
 SUNWgssx (64-bit)
MT-LevelSafe

SEE ALSO

 

gss_acquire_cred(3GSS), gss_create_empty_oid_set(3GSS), attributes(5)

GSS-API Programming Guide


SunOS 5.9Go To TopLast Changed 18 Apr 2000

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.