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/ Microsoft® SQL Server™ 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.

See Also