dced_keytab_release_cursor(3dce)

Synopsis

#include <dce/dced.h>

void dced_keytab_release_cursor(

dced_keytab_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_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
Routines: dced_keytab_initialize_cursor(3dce)

dced_keytab_get_next_key(3dce)

Book: OSF DCE Application Development Guide - Core Components