NAME

sec_cred_get_extended_attrs — Returns extended attributes from a privilege handle

Synopsis

void sec_cred_get_extended_attrs(
sec_cred_pa_handle_t callers_pas,
sec_cred_attr_cursor_t ∗cursor,
sec_attr_t ∗attr,
error_status_t ∗status);

Parameters

Input

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

Input/Output

cursorA cursor of type sec_cred_attr_cursor_t that has been initialized by the sec_cred_initialize_attr_cursor() routine.  As input cursor must be initialized.  As output, cursor is positioned at the first attribute after the returned attribute. 

Output

attrA pointer to a value of sec_attr_t that contains extended registry attributes. 

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

Description

The sec_cred_get_extended_attrs() routine extracts extended registry initialized from the privilege attribute handle identified by callers_pas. 

Before you execute call, 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. 

   •A sec_cred_initialize_attr_cursor() to initialize a sec_attr_t. 

To obtain all the extended registry attributes in the privilege attribute handle, repeat sec_cred_get_extended_attrs() calls until the status message no_more_entries_available is returned. 

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

sec_cred_s_invalid_cursor

sec_cred_s_no_more_entries

error_status_ok

Related Information

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