| ## sec_login_cred_get_initiator(3sec) Returns information about the delegation initiator in a specified login context Synopsis #include <dce/sec_login.h> sec_cred_pa_handle_t sec_login_cred_get_initiator( sec_login_handle_t login_context, error_status_t *status); Parameters Input login_context A value of sec_login_handle_t that provides an opaque handle to a login context for which delegation has been enabled. Output status A pointer to the completion status. On successful completion, status is assigned error_status_ok. Otherwise, it returns an error. Description The sec_login_cred_get_initiator( ) routine returns a handle of type sec_cred_pa_handle_t to the privilege attributes of the delegation initiator. The login context identified by login_context contains all members in the delegation chain. This call returns a handle (sec_cred_pa_handle_t) to the privilege attributes of the initiator. 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 single delegate. Use the sec_cred_free_pa_handle( ) call to free the resources allocated to the sec_cred_pa_handle_t handle. Files /usr/include/dce/sec_login.idl The idl file from which dce/sec_login.h was derived. 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_login_s_invalid_context error_status_ok Related Information Functions: sec_intro(3sec) sec_cred_get_pa_data(3sec) sec_cred_get_extended_attrs(3sec) sec_cred_get_v1_pac(3sec) sec_cred_get_tgt_restrictions(3sec) sec_cred_get_deleg_restrictions(3sec) sec_cred_get_opt_restrictions(3sec) sec_cred_get_req_restrictions(3sec) sec_cred_get_delegation_type(3sec) ##