Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_cred_get_extended_attrs- 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 attributes 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 argument.

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.

FILES

/usr/include/dce/sec_cred.idl

The idl file from which dce/sec_cred.h was derived.


ERRORS

sec_cred_s_invalid_pa_handle

sec_cred_s_invalid_cursor

sec_cred_s_no_more_entries

error_status_ok

SEE ALSO

Functions: sec_cred_get_initiator(), sec_cred_get_delegate(), sec_cred_initialize_attr_cursor().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index