gss_context_time()--Get Number of Seconds Security Context Remains Valid

Syntax

 #include <gssapi.h>

 OM_uint32 gss_context_time(
     OM_uint32 *    minor_status,
     gss_ctx_id_t   context_handle,  
     OM_uint32 *    time_rec);

  Service Program Name: QSYS/QKRBGSS

  Default public authority: *USE

  Threadsafe: Yes

The gss_context_time() function checks the specified security context and returns the number of seconds that the context remains valid. The returned value is GSS_C_INDEFINITE if the context does not have an expiration time. The Kerberos security mechanism does support context expiration and returns the time remaining before the underlying service ticket expires.

Parameters

minor_status (Output): A status code from the security mechanism.
context_handle (Input): The context to be checked.
time_rec (Output): The number of seconds that the context remains valid.

Return Value

The return value is one of the following status codes:

GSS_S_COMPLETE: The routine completed successfully.
GSS_S_CONTEXT_EXPIRED: The referenced context has expired.
GSS_S_CREDENTIALS_EXPIRED: The credentials associated with the referenced context have expired.
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.
GSS_S_NO_CONTEXT: The referenced context does not exist.

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 ]