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

 NAME
   sec_rgy_attr_cursor_alloc - Allocates resources to a cursor used by
                               the sec_rgy_attr_lookup_by_id call

 SYNOPSIS

   #include <dce/sec_rgy_attr.h>

   void sec_rgy_attr_cursor_alloc(
           sec_attr_cursor_t *cursor,
           error_status_t *status);

 PARAMETERS

   Output

   cursor A pointer to a sec_attr_cursor_t.

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

 DESCRIPTION

   The sec_rgy_attr_cursor_alloc() call allocates resources to a cursor
   used with the sec_rgy_attr_lookup_by_id call.  This routine, which is
   a local operation, does not initialize cursor.

   The sec_rgy_attr_cursor_init() routine, which makes a remote call,
   allocates and initializes the cursor.  In addition,
   sec_rgy_attr_cursor_init() returns the total number of attributes
   attached to the object as an output parameter;
   sec_rgy_attr_cursor_alloc() does not.

   Permissions Required

   None

 FILES

   SYS$COMMON:[DCE$LIBRARY]SEC_ATTR_BASE.IDL
                The idl file from which dce/sec_attr_base.h was derived.

 ERRORS

   no such object

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_attr_cursor_init
              sec_rgy_attr_cursor_release
              sec_rgy_attr_cursor_reset
              sec_rgy_attr_lookup_by_id