VMS Help DCE, dce_intro, dce_attr_intro, dce_attr_sch_cursor_reset  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   dce_attr_sch_cursor_reset - Resets a cursor that has been allocated
                               with either dce_attr_sch_cursor_init()
                               or dce_attr_sch_cursor_alloc().

 SYNOPSIS

   #include <dce/dce_attr_base.h>

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

 PARAMETERS

   Input/Output

   cursor
          A pointer to a dce_attr_cursor_t. As an input parameter, an
          initialized cursor. As an output parameter, cursor is reset
          to the first attribute in the schema.

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

 DESCRIPTION

   The dce_attr_sch_cursor_reset() routine resets a dce_attr_cursor_t
   that has been allocated by either a dce_attr_sch_cursor_init() or
   dce_attr_sch_cursor_alloc(). The reset cursor can then be used to
   process a new dce_attr_sch_scan query by reusing the cursor instead
   of releasing and re-allocating it. This is a local operation and
   makes no remote calls.

   Permissions Required

   None.

 FILES

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

 ERRORS

   error_status_ok

 RELATED INFORMATION

   Functions: dce_attr_intro
              dce_attr_sch_cursor_init
              dce_attr_sch_cursor_alloc
              dce_attr_sch_scan