sec_cred_get_pa_data(3sec)
Returns identity information from a privilege attribute handle
Synopsis
#include <dce/sec_cred.h>
sec_id_pa_t *sec_cred_get_pa_data(
sec_cred_pa_handle_t callers_pas,
error_status_t *status);
Parameters
Input
callers_pas
A 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
status
A 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 principal's local 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: