HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 5 GSSAPI (Generic Security Services Application Programming Interface)

gss_add_oid_set_member — Add an object identifier to a set

 » Table of Contents

 » Glossary

 » Index

C Prototype

OM_uint32 gss_add_oid_set_member(
OM_uint32 * minor_status,
gss_OID member_oid,
gss_OID_set * oid_set );

Arguments

minor_status (output) 

An implementation-specific status code.

member_oid (input) 

The object identifier to be copied into the set.

oid_set (input/output) 

The set in which the object identifier should be inserted.

Description

This routine adds an object identifier to an object identifier set. It is intended for use in conjunction with gss_create_empty_oid_set when constructing a set of mechanism OIDs for input to gss_acquire_cred. The oid_set argument must refer to an OID-set that was created by GSSAPI (for example, a set returned by gss_create_empty_oid_set). GSSAPI creates a copy of the member_oid and inserts this copy into the set, expanding the storage allocated to the OID-set's elements array if necessary. The routine may add the new member OID anywhere within the elements array; if the member_oid is already present, the oid_set remains unchanged.

Return Values

This routine returns the following GSS status code:

GSS_S_COMPLETE

Successful completion.