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

 NAME
   sec_rgy_attr_sch_scan - Read a specified number of schema entries

 SYNOPSIS

   #include <dce/sec_rgy_attr_sch.h>

   void sec_rgy_attr_sch_scan(
           sec_rgy_handle_t context,
           sec_attr_component_name_t schema_name,
           sec_attr_cursor_t *cursor,
           unsigned32 num_to_read,
           unsigned32 *num_read,
           sec_attr_schema_entry_t schema_entries[],
           error_status_t *status);

 PARAMETERS

   Input

   context
          An opaque handle bound to a registry server.  Use
          sec_rgy_site_open() to acquire a bound handle.

   schema_name
          Reserved for future use.

   num_to_read
          An unsigned 32-bit integer specifying the size of the
          schema_entries[] array and the maximum number of entries to be
          returned.

   Input/Output

   cursor
          A pointer to a sec_attr_cursor_t.  As input cursor must be
          allocated and can be initialized. If cursor is not initialized,
          sec_rgy_attr_sch_scan will initialized.  As output, cursor is
          positioned at the first schema entry after the returned entries.

   Output

   num_read
          A pointer an unsigned 32-bit integer specifying the number of
          entries returned in schema_entries[].

   schema_entries[]
          A sec_attr_schema_entry_t that contains an array of the returned
          schema entries.

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

 DESCRIPTION

   The sec_rgy_attr_sch_scan() routine reads schema entries. The read
   begins at the entry at which the input cursor is positioned and ends
   after the number of entries specified in num_to_read.

   The input cursor must have been allocated by either the
   sec_rgy_attr_sch_cursor_init() or the sec_rgy_attr_sch_cursor_alloc()
   call.  If the input cursor is not initialzed, sec_rgy_attr_sch_scan()
   initializes it; if cursor is initialized, sec_rgy_attr_sch_scan()
   simply advances it.

   To read all entries in a schema, make successive sec_rgy_attr_sch_scan()
   calls. When all entries have been read, the call returns the message
   no_more_entries.

   This routine is useful as a browser.

   Permissions Required

   The sec_rgy_attr_sch_scan() routine requires r permission on the
   attr_schema object.

 FILES

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

 ERRORS

   sec_attr_bad_cursor

   sec_attr_unauthorized

   sec_attr_svr_unavailable

   sec_attr_no_memory

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_attr_sch_cursor_init
              sec_rgy_attr_sch_cursor_alloc
              sec_rgy_attr_sch_cursor_release