Name

dced_release_cursor - Releases the resources of a cursor which traverses a dced service’s list of entries

Synopsis

#include <dce/dced.h> void dced_release_cursor(
dced_cursor_t ∗cursor,
error_status_t ∗status);

Parameters

Input/Output

cursorSpecifies the cursor for which resources are released. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The dced_release_cursor() routine releases the resources of a cursor initially set by the dced_initilalize_cursor() routine and used by the dced_entry_get_next() routine. 

Prior to calling this routine, the application must have first established a valid dced binding handle by calling either the dced_binding_create() or dced_binding_from_rpc_binding() routine, and then the application must have called the dced_initialize_cursor() routine. 

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: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_entry_get_next(3dce), dced_initialize_cursor(3dce). 

Books: OSF DCE Application Development Guide.