dced_release_cursor(3dce)
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
cursor
Specifies the cursor for which resources are released.
Output
status
Returns 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
Routines: dced_initialize_cursor(3dce)
dced_binding_from_rpc_binding(3dce)
Book: OSF DCE Application Development Guide - Core Components