NAME

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

13m

error_status_ok

RELATED INFORMATION

Functions: dce_attr_intro(3dce), dce_attr_sch_cursor_init(3dce), dce_attr_sch_cursor_alloc(3dce), dce_attr_sch_scan(3dce)/B>