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

 NAME
   sec_rgy_attr_sch_cursor_alloc - Allocates resources to a cursor
                                   used with the sec_rgy_attr_sch_scan
                                   call

 SYNOPSIS

   void sec_rgy_att_sch_cursor_alloc(
           dce_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_sch_cursor_alloc() call allocates resources to a
   cursor used with the sec_rgy_attr_sch_scan() call.  This routine,
   which is a local operation, does not initialize cursor.

   The sec_rgy_attr_sch_cursor_init() routine, which makes a remote
   call, allocates and initializes the cursor.  In addition,
   sec_rgy_attr_sch_cursor_init() returns the total number of entries
   found in the schema as an output parameter;
   sec_rgy_attr_sch_cursor_alloc() does not.

   Permissions Required

   None.

 FILES

   SYS$COMMON:[DCE$LIBRARY]SEC_RGY_ATTR_SCH.IDL
                The idl file from which dce/sec_rgy_attr_sch.id was
                derived.

 ERRORS

   sec_attr_no_memory

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_attr_sch_cursor_init
              sec_rgy_attr_sch_cursor_release
              sec_rgy_attr_sch_scan