Sun OpenSSO Enterprise 8.0 C API Reference for Application and Web Policy Agent Developers

am_sso_get_time_left()

Retrieves the time left in the session associated with the specified single sign-on token handle.

Syntax

#include "am_sso.h"
AM_EXPORT time_t
am_sso_get_time_left(const am_sso_token_handle_t sso_token_handle);

Parameters

This function takes the following parameters:

sso_token_handle

Pointer to a am_sso_token_handle_t type.

Returns

This function returns the time left on this session in seconds, or the standard time_t data structure in the form (time_t) -1 if the token is invalid or some other type of error occurs. Detailed error information is logged.