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

 #include <gssapi.h>

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

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

Error Messages