dbcursorclose

DB Library for C

DB Library for C

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