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

am_sso_get_principal()

Retrieves the principal (user) associated with the specified single sign-on token handle.

Syntax

#include "am_sso.h"
AM_EXPORT const char *
am_sso_get_principal(const am_sso_token_handle_t sso_token);

This function takes the following parameter:

sso_token

Pointer to a am_sso_token_handle_t type.

Returns

This function returns the principal (user) of the specified session, or NULL if the handle is invalid or any other error occurred.