gss_inquire_cred_by_mech(3) Library Functions Manual gss_inquire_cred_by_mech(3)
NAME
gss_inquire_cred_by_mech() - provide the calling application per-mechanism information about a credential
SYNOPSIS
DESCRIPTION
The routine provides per-mechanism information about a credential.
Input Parameters
cred_handle Specifies a handle for the target credential. To get information about the default credential, specify
mech_type Set of security mechanisms for which information should be returned.
Output Parameters
name Returns the principal name asserted by the credential. If the principal name is not required, specify NULL.
initiator_lifetime Returns the number of seconds for which the credential will remain capable of initiating security contexts under the
specified mechanism. If the credential can no longer be used to initiate contexts, or if the credential usage for
this mechanism is this parameter will be set to zero.
If the implementation does not support expiration of initiator credentials, the parameter returns the value If an
expiration time is not required, specify NULL.
acceptor_lifetime Returns the number of seconds for which the credential will remain capable of accepting security contexts under the
specified mechanism.
If the implementation does not support expiration of initiator credentials, the parameter returns the value If an
expiration time is not required, specify NULL.
cred_usage Returns one of the following values describing how the application can use the credential:
If no usage information is required, specify NULL.
minor_status Returns a status code from the security mechanism.
STATUS CODES
The following status codes can be returned:
The routine was completed successfully.
The credentials expired. If the
lifetime parameter was passed as NULL, it is set to 0 (zero).
The credentials were invalid.
The routine failed. Check the
minor_status parameter for details.
The routine could not access the credentials.
AUTHOR
was developed by Sun Microsystems, Inc.
SEE ALSO
gss_acquire_cred(3).
The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add to
gss_inquire_cred_by_mech(3)
