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 ]