sec_cred_get_initiator(3sec)
Returns the privilege attributes of the initiator of a delegation chain
Synopsis
#include <dce/sec_cred.h>
sec_cred_pa_handle_t sec_cred_get_initiator(
rpc_authz_cred_handle_t callers_identity,
error_status_t *status);
Parameters
Input
callers_identity
A credential handle of type rpc_authz_cred_handle_t. This handle is supplied as output of the rpc_binding_inq_auth_caller( ) call.
Output
status
A pointer to the completion status. On successful completion, status is assigned error_status_ok.
Description
The sec_cred_get_initiator( ) routine returns a handle to the privilege attributes of the initiator of a delegation chain that performed an authenticated
RPC operation.
The credential handle identified by callers_identity contains authentication and authorization information for all delegates in the chain. This call returns a handle (sec_cred_pa_handle_t) to the privilege attributes of the client that initiated the delegation chain. The sec_cred_pa_handle_t returned by this call is used in other sec_cred_get... calls to obtain privilege attribute information for the initiator.
Before you execute sec_cred_get_initiator( ), you must execute an rpc_binding_inq_auth_caller( ) call to obtain an rpc_authz_cred_handle_t for the callers_identity 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_auth_handle
error_status_ok
Related Information
Functions:
rpc_binding_inq_auth_caller(3rpc)
sec_cred_get_deleg_restrictions(3sec)
sec_cred_get_delegation_type(3sec)
sec_cred_get_extended_attrs(3sec)
sec_cred_get_opt_restrictions(3sec)
sec_cred_get_req_restrictions(3sec)
sec_cred_get_tgt_restrictions(3sec)