VMS Help DCE_SECURITY, API Routines, sec_cred_get_extended_attrs  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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
   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

   sec_cred_s_invalid_pa_handle

   sec_cred_s_invalid_cursor

   sec_cred_s_no_more_entries

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              sec_cred_initialize_attr_cursor
              sec_cred_get_initiator
              sec_cred_get_delegate