NAME

sec_cred_get_pa_data — Returns identity information from a privilege attribute handle

Synopsis

sec_id_pa_t ∗sec_cred_get_pa_data(
sec_cred_pa_handle_t callers_pas,
error_status_t ∗status);

Parameters

Input

callers_pasA handle of type sec_cred_pa_handle_t to a principal’s privilege attributes.  This handle is supplied as output of either the sec_cred_get_initiator() call or sec_cred_get_delegate() call. 

Output

statusA pointer to the completion status.  On successful completion, status is assigned error_status_ok. 

Description

The sec_cred_get_pa_data() routine extracts identity information from the privilege attribute handle specified by callers_pas and returns it in a sec_id_pa_t.  The identity information includes an identifier of the princpal’s locall cell and the principal’s local and foreign group sets. 

Before you execute sec_cred_get_pa_data(), you must execute a sec_cred_get_initiator() or sec_cred_get_delegate() call to obtain a sec_cred_pa_handle_t for the callers_pas parameter. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

sec_cred_s_invalid_pa_handle

error_status_ok

Related Information

Functions: sec_cred_get_delegate(3sec), sec_cred_get_initiator(3sec), sec_intro(3sec).