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

 NAME
   sec_cred_initialize_attr_cursor - Initialize a sec_attr_cursor_t used
                                     by the sec_cred_get_extended_attrs()
                                     call

 SYNOPSIS

   #include <dce/sec_cred.h>

   void sec_cred_initialize_attr_cursor (
           sec_cred_attr_cursor_t *cursor,
           error_status_t *status);

 PARAMETERS

   Input/Output

   cursor
          As input, a pointer to a sec_cred_attr_cursor_t to be
          initialized.  As output a pointer to an initialized
          sec_cred_attr_cursor_t.

   Output

   status
          A pointer to the completion status.  On successful completion,
          the routine returns error_status_ok.  Otherwise, it returns an
          error.

 DESCRIPTION

   The sec_cred_initialize_attr_cursor() routine allocates and initializes
   a cursor of type sec_cred_attr_cursor_t for use with the
   sec_cred_get_extended_attrs() call. Use the sec_cred_free_attr_cursor()
   call to free the resources allocated to cursor.

 ERRORS

   sec_login_s_no_memory

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              sec_cred_get_extended_attrs
              sec_cred_free_attr_cursor