PreviousNext

The sec_rgy_attr_sch_scan( ) Call

The sec_rgy_attr_sch_scan( ) call reads a specified number of schema entries from the attribute schema.

The number of entries to read is specified as an unsigned 32-bit integer. The read begins at the entry at which the sec_attr_cursor_t cursor is positioned and continues through the number of entries specified. The cursor must be allocated but can be initialized or uninitialized since sec_rgy_attr_sch_scan( ) initializes any uninitialized cursor it receives as input.

The call output includes an array of sec_attr_schema_entry_t values and a 32-bit integer that specifies the number of schema entries returned.

To read through all entries in a schema, continue making sec_rgy_attr_sch_scan( ) calls, until the no_more_entries message is received. When all calls are complete, release the resources allocated to the sec_attr_cursor_t cursor by using the sec_rgy_attr_sch_cursor_release( ) call.