PreviousNext

dce_attr_sch_cursor_release(3dce)

Releases states associated with 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_sch_cursor_init(

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, cursor must have been initialized to the first entry in a schema. As an output parameter, cursor is uninitialized with all resources released.

Output

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_init( ) routine releases the resources allocated to a cursor that has been allocated by either a dce_attr_sch_cursor_init( ) or dce_attr_sch_cursor_alloc( ). This call is a local operation and makes no remote calls.

Permissions Required
None.

Files

/usr/include/dce/dce_attr_base.idl
The idl file from which dce/dce_attr_base.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)

dce_attr_sch_cursor_reset(3dce)

dce_attr_sch_scan(3dce)