NAME

gss_context_time — Checks the number of seconds for which the context will remain valid

Synopsis

OM_uint32  gss_context_time(
OM_uint32 ∗minor_status,
gss_ctx_id_t context_handle,
OM_int32 ∗time_rec);

Parameters

Input

context_handle
Specifies the context to be checked.

Output

time_recReturns the number of seconds that the context will remain valid.  Returns a 0 (zero) if the context has already expired. 

minor_status
Returns a status code from the security mechanism.

Description

The gss_context_time() routine checks the number of seconds for which the context will remain valid. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

GSS_S_COMPLETE
The routine was completed successfully.

GSS_S_CONTEXT_EXPIRED
The context has already expired.

GSS_S_CREDENTIALS_EXPIRED
The context is recognized but the associated credentials have expired.

GSS_S_NO_CONTEXT
The context identified in the context_handle parameter was not valid. 

GSS_S_FAILURE
The routine failed.  See the minor_status parameter return value for more information.