gss_context_time(3sec)

Synopsis

#include <dce/gssapi.h>

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_rec
Returns 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.

Status Codes
The following describes a partial list of codes (messages) that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all messages. The following status codes can be returned:

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.