NAME
   dce_attr_sch_cursor_alloc - Allocates resources to a cursor used
                               with the dce_attr_sch_scan call

 SYNOPSIS

   #include <dce/dce_attr_sch.h>

   void dce_rgy_attr_cursor_alloc( dce_attr_cursor_t *cursor,
                                   error_status_t *status );

 PARAMETERS

   Output

   cursor    A pointer to a dce_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 dce_attr_sch_cursor_alloc() call allocates resources to a
   cursor used with the dce_attr_sch_scan call.  This routine,
   which is a local operation, does not initialize cursor.

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

   Permissions Required

   The dce_attr_sch_cursor_alloc() call requires appropriate
   permissions on the schema object. These permissions are managed
   by the target server.

 FILES

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

 ERRORS

   dce_attr_s_no_memory

   error_status_ok

 RELATED INFORMATION

   Functions: dce_attr_intro
              dce_attr_sch_cursor_init
              dce_attr_sch_cursor_release
              dce_attr_sch_scan