sec_cred_get_extended_attrs(3sec)
Returns extended attributes from a privilege handle
Synopsis
#include <dce/sec_cred.h>
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_pas
A 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
cursor
A 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
attr
A pointer to a value of sec_attr_t that contains extended registry attributes.
status
A 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_initialize_attr_cursor(3sec)