gss_inquire_names_for_mech()--Get Name Types Supported by Security Mechanism

Syntax

 #include <gssapi.h>

 OM_uint32 gss_inquire_names_for_mech (  
     OM_uint32 *    minor_status,  
     gss_OID      mech_type,
     gss_OID_set *    mech_names);

  Service Program Name: QSYS/QKRBGSS

  Default public authority: *USE

  Threadsafe: Yes

The gss_inquire_names_for_mech() function returns the name types supported by a security mechanism.

Parameters

minor_status (Output)

A status code from the security mechanism.

mech_type (Input)

The mechanism to be queried as follows:

gss_mech_krb5_old	Beta Kerberos V5 mechanism
gss_mech_krb5	Kerberos V5 mechanism

mech_names (Output)

The name types supported by the specified mechanism. The gss_OID_set returned for this parameter should be released by calling the gss_release_oid_set() routine when it is no longer needed.

Return Value

The return value is one of the following status codes:

GSS_S_BAD_MECH: The requested mechanism is not supported.
GSS_S_COMPLETE: The routine completed successfully.
GSS_S_FAILURE: The routine failed for reasons that are not defined at the GSS level. The minor_status return parameter contains a mechanism-dependent error code describing the reason for the failure.

Authorities

Object Referred to	Data Authority Required
Each directory in the path name preceding the configuration file	*X
Configuration file	*R

Error Messages

Message ID	Error Message Text
CPE3418 E	Possible APAR condition or hardware failure.

API introduced: V5R1

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]