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/ 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

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.

See Also