Returns or sets a default value that determines the number of seconds the ODBC driver waits before abandoning an attempt to connect to a data source.
Syntax
object.rdoDefaultLoginTimeout [= value]
The rdoDefaultLoginTimeout property syntax has these parts:
Part | Description |
object | An object expression that evaluates to an object in the Applies To list. |
value | A Long expression that specifies the number of seconds as described in Settings. |
Settings
The setting for value is the number of seconds to wait for a login request to complete before returning a trappable error or firing a QueryTimeout event. A setting of 0 indicates the timeout is disabled, and a connection attempt will wait indefinitely — or until the connection is complete.
Remarks
The rdoDefaultLoginTimeout property is used as an application-wide default unless the LoginTimeout property of the rdoEnvironment object is used to override this value.
Login requests are made when the RemoteData control creates an rdoConnection object, or when you use the OpenConnection or EstablishConnection methods of the rdoEnvironment object. The maximum value is dependent on the data source driver. The ODBC driver determines the maximum permissible LoginTimeout value — any attempt to set a value higher than this value is reset to this driver-dependent maximum value.
The default timeout value, if not specified, is 15 seconds.
When the timeout period is exhausted, the ConnectionTimeout event on the parent rdoEnvironment object fires.
Note When you use Data Access Objects (DAO), the LOGINTIMEOUT argument is used in the Connect property, this is not a valid argument for ODBC connect strings. Use the rdoDefaultLoginTimeout property instead.