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™ 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.

See Also