DBSETLTIME

Sets the connection-specific connection timeout in a LOGINREC structure.

Syntax

RETCODE DBSETLTIME (
PLOGINREC ploginrec,
DWORD seconds);

where

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 SQL Server before timing out. The following special values are also available:

seconds	Description
TIMEOUT_IGNORE	Use the global connection timeout set using dbsetlogintime.
TIMEOUT_INFINITE	No timeout.
TIMEOUT_MAXIMUM	Maximum DB-Library connection timeout.

Returns

SUCCEED or FAIL.

Remarks

The seconds value overrides the global timeout value set using dbsetlogintime or the default login timeout.

See Also

dblogin, dbopen, DBSETLAPP, DBSETLHOST, dbsetlogintime, DBSETLUSER