sec_rgy_attr_sch_cursor_reset(3sec)
Resets a cursor that has been allocated
Synopsis
#include <dce/sec_rgy_attr_sch.h>
void dce_attr_cursor_reset(
sec_attr_cursor_t *cursor,
error_status_t *status);
Parameters
Input/Output
cursor
A pointer to a sec_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 sec_rgy_attr_sch_cursor_reset( ) routine resets a dce_attr_cursor_t that has been allocated by either a sec_rgy_attr_sch_cursor_init(
) or sec_rgy_attr_sch_cursor_alloc( ). The reset cursor can then be used to process a new sec_rgy_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
/usr/include/dce/sec_rgy_attr_sch.idl
The idl file from which dce/sec_rgy_attr_sch.h was derived.
Errors
The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
sec_attr_bad_cursor
error_status_ok
Related Information
Functions:
sec_rgy_attr_sch_cursor_init(3sec)
sec_rgy_attr_sch_cursor_alloc(3sec)