am_sso_get_principal_set()

Retrieves a set of principals associated with the specified single sign-on token handle.

Syntax

#include "am_sso.h"
AM_EXPORT am_string_set_t *
am_sso_get_principal_set(const am_sso_token_handle_t sso_token);

Parameters

This function takes the following parameter:

sso_token

Pointer to a am_sso_token_handle_t type.

Returns

This function returns the am_string_set_t type (defined in the <am_string_set.h> header file) that points to the set of principals associated with the specified single sign-on token handle. It returns NULL if the applicable property is not set or has no value.