Name

dced_keytab_release_cursor - Releases the resources of a cursor that traverses a key table’s list of keys (server passwords)

Synopsis

#include <dce/dced.h> void dced_keytab_release_cursor(
dced_keytab_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_keytab_release_cursor() routine releases the cursor and resources initially set by the dced_keytab_initialize_cursor() routine and used by the dced_keytab_get_next_key() routine. 

Prior to calling this routine, the application must have first established a valid dced binding handle by calling either dced_binding_create() or dced_binding_from_rpc_binding(), and then the application must have called the dced_keytab_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

dced_s_bad_binding

dced_s_no_support

Related Information

Functions: dced_keytab_get_next_key(3dce), dced_keytab_initialize_cursor(3dce). 

Books: OSF DCE Application Development Guide.