GSS_INQUIRE_NAMES_FOR_MECH(3GSS)
Generic Security Services API Library Functions

NAME

gss_inquire_names_for_mech - list the name-types supported by the
specified mechanism

SYNOPSIS

cc [flag ...] file... -lgss [library ...]
#include <gssapi/gssapi.h>

OM_uint32 gss_inquire_names_for_mech(OM_uint32 *minor_status,
const gss_OID mechanism,gss_OID_set *name_types);

DESCRIPTION

The gss_inquire_names_for_mech() function returns the set of name-
types supported by the specified mechanism.

PARAMETERS

The parameter descriptions for gss_inquire_names_for_mech() follow:

minor_status
A mechanism-specific status code.


mechanism
The mechanism to be interrogated.


name_types
Set of name-types supported by the specified
mechanism. The returned OID set must be freed by the
application after use with a call to
gss_release_oid_set(3GSS).

ERRORS

The gss_inquire_names_for_mech() function may return the following
values:

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(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Safe |
+---------------+-----------------+

SEE ALSO

gss_release_oid_set(3GSS), attributes(7)


Solaris Security for Developers Guide

January 15, 2003
GSS_INQUIRE_NAMES_FOR_MECH(3GSS)