dbcursorclose

Closes the client cursor, transparent server cursor, or explicit server cursor, and releases the memory associated with a cursor handle or connection.

Syntax

RETCODE dbcursorclose ( PDBHANDLE handle );

Arguments
handle
Is a DBPROCESS connection or DBCURSOR cursor handle. Cast handle to a PDBHANDLE value (for example, (PDBHANDLE)mydbproc or (PDBHANDLE)mycursor) to avoid compiler warnings. The following table shows the dbcursorclose operation for each type of handle.

 

handle Operation
PDBCURSOR Closes the specified cursor.
PDBPROCESS Closes all open cursors using the specified connection.

Returns

SUCCEED or FAIL. If handle is a DBPROCESS connection, and this function returns FAIL, call dbcursorclose again to continue closing all open cursors for the specified connection.

Remarks

After issuing dbcursorclose, the cursor handle should not used.

See Also
Bulk-Copy Functions dbcursorfetch
dbcursor dbcursorinfo
dbcursorbind dbcursoropen
dbcursorcolinfo  

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.