dbdead
Determines whether a particular DBPROCESS is inactive.
Syntax
BOOL dbdead ( 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
TRUE or FALSE.
Remarks
dbdead is particularly useful in user-supplied error handlers.
If a DBPROCESS is inactive, almost every DB-Library function that receives it as a parameter immediately fails, calling the user-supplied error handler. You must close an inactive DBPROCESS connection with dbclose and open a new connection with dbopen.
dbdead usually returns TRUE when a network connection is broken. Note any other errors or messages that you receive.