DB Library for C
dbsetltime
Sets the connection-specific connection time-out in a LOGINREC structure.
Syntax
RETCODE DBSETLTIME (
PLOGINREC ploginrec,
DWORD seconds);
Arguments
ploginrec
A pointer to a LOGINREC structure, which is passed as a parameter to dbopen. You can get one of these pointers by calling dblogin.
seconds
The number of seconds that DB-Library waits for a login response from Microsoft® SQL Server™ 2000 before timing out. The following special values are also available.
seconds | Description |
---|---|
TIMEOUT_IGNORE | Use the global connection time-out set using dbsetlogintime. |
TIMEOUT_INFINITE | No time-out. |
TIMEOUT_MAXIMUM | Maximum DB-Library connection time-out. |
Returns
SUCCEED or FAIL.
Remarks
The seconds value overrides the global time-out value set using dbsetlogintime or the default login time-out.