gss_inquire_mechs_for_name(3) — Subroutines
NAME
gss_inquire_mechs_for_name − Identify security mechanisms that can process a given name.
SYNOPSIS
#include <gssapi/gssapi.h>
OM_uint32 gss_inquire_mechs_for_name(
OM_uint32 ∗ minor_status,
const gss_name_t input_name,
gss_OID_set ∗ mech_types );
PARAMETERS
minor_status
Kerberos 5 error code.
input_name
Name to be queried.
The application must obtain the name beforehand using a function such as gss_import_name().
mech_types
Object identifier (OID) set of security mechanisms that may support the specified name.
The returned OID set must be freed by the application after use with a call to gss_release_oid_set().
DESCRIPTION
The gss_inquire_mechs_for_name() function identifies the mechanisms that can process the specified name. Since Kerberos 5 is the only security mechanism supported by the HP Application Security Toolkit, this function always returns it as the only security mechanism in the OID set.
This function is intended for use with applications that are designed for multiple mechanisms.
RETURN VALUES
| 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 |