gss_inquire_names_for_mech(3) — Subroutines
NAME
gss_inquire_names_for_mech − Identify name types supported by a specific security mechanism.
SYNOPSIS
#include <gssapi/gssapi.h>
OM_uint32 gss_inquire_names_for_mech(
OM_uint32 ∗ minor_status,
const gss_OID mechanism,
gss_OID_set ∗ name_types );
PARAMETERS
minor_status
Kerberos 5 error code.
mechanism
Security mechanism to be queried.
name_types
Object identifier (OID) 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().
DESCRIPTION
The gss_inquire_names_for_mech() function identifies the name types that are supported by a particular mechanism. Since Kerberos 5 is the only security mechanism supported by the HP Application Security Toolkit, this function returns the name types Kerberos 5 supports. gss_import_name() contains a list of the supported name types.
This function can be used to verify that a name type is valid or to generate a list of name types from which to choose.
RETURN VALUES
| GSS_S_BAD_MECH | xx01xxxx |
| GSS_S_BAD_NAME | xx02xxxx |
| GSS_S_BAD_NAMETYPE | xx03xxxx |
| GSS_S_CALL_INACCESSIBLE_READ | 01xxxxxx |
| GSS_S_CALL_INACCESSIBLE_WRITE | 02xxxxxx |
| GSS_S_COMPLETE | 00000000 |
| GSS_S_FAILURE | xx0Dxxxx |