CDaoWorkspace::GetLoginTimeout

static short PASCAL GetLoginTimeout( );
throw( CDaoException, CMemoryException );

Return Value

The number of seconds before an error occurs when you attempt to log in to an ODBC database.

Remarks

Call this member function to get the current value of the DAO LoginTimeout property for the workspace. This value represents the number of seconds before an error occurs when you attempt to log in to an ODBC database. The default LoginTimeout setting is 20 seconds. When LoginTimeout is set to 0, no timeout occurs and the communication with the data source might hang.

When you are attempting to log in to an ODBC database, such as Microsoft SQL Server, the connection may fail as a result of network errors or because the server is not running. Rather than waiting for the default 20 seconds to connect, you can specify how long the database engine waits before it produces an error. Logging in to the server happens implicitly as part of a number of different events, such as running a query on an external server database.

For more information about workspaces, see the article DAO Workspace. For more information about working with ODBC data sources through DAO, see the article DAO External: Working with External Data Sources. Both articles are in Visual C++ Programmer's Guide. For related information, see the topic "LoginTimeout Property" in DAO Help.

CDaoWorkspace OverviewClass MembersHierarchy Chart

See Also   CDaoWorkspace::SetLoginTimeout