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

cursorA 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. 

statusA 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 the dce_attr_sch_cursor_init() routine or the dce_attr_sch_cursor_alloc() routine.  The reset cursor can then be used to process a new dce_attr_sch_scan query by reusing the cursor instead of releasing and reallocating 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_alloc(3dce), dce_attr_sch_cursor_init(3dce), dce_attr_sch_scan(3dce).