DB Library for C
dbclose
Closes and frees a single DBPROCESS structure.
Syntax
RETCODE dbclose ( PDBPROCESS dbproc );
Arguments
dbproc
Is the DBPROCESS structure that is the handle for a particular workstation or Microsoft® SQL Server™ 2000 process. It contains all the information that DB-Library uses to manage communications and data between the workstation and SQL Server.
Returns
SUCCEED or FAIL
Remarks
The dbclose function is the inverse of dbopen. It cleans up any activity associated with a single DBPROCESS structure and frees the memory. It also closes the corresponding network connection and any open cursors.
To close all open DBPROCESS structures, use dbexit.
Calling dbclose with a parameter not returned by dbopen causes an error.