gss_inquire_cred(3)gss_inquire_cred(3)NAMEgss_inquire_cred() - provide the calling application information about
a credential
SYNOPSISDESCRIPTION
The routine provides information about a credential to the calling
application. The calling application must first have called the rou‐
tine for a handle for the credential.
Input Parameters
cred_handle Specifies a handle for the target credential. To
get information about the default credential,
specify
Output Parameters
name Returns the principal name asserted by the cre‐
dential. If the principal name is not required,
specify NULL.
lifetime Returns the number of seconds for which the cre‐
dential will remain valid.
If the credential expired, the parameter returns
a 0 (zero). If there is no credential expira‐
tion, the parameter returns the value If an expi‐
ration 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.
mechs Returns a set of security mechanisms supported by
the credential.
minor_status Returns a status code from the security mecha‐
nism.
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 ALSOgss_acquire_cred(3).
The manpages for DCE-GSSAPI are included with the DCE-CoreTools prod‐
uct. To see those manpages add to
gss_inquire_cred(3)