dce_attr_sch_cursor_reset(3dce)
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
/usr/include/dce/dce_attr_sch.idl
The idl file from which dce/dce_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.
error_status_ok
Related Information
Functions: dce_attr_intro(3dce)
dce_attr_sch_cursor_init(3dce)
dce_attr_sch_cursor_alloc(3dce)