CDatabase::OpenEx

项目
03/01/2013

调用该成员函数初始化新构造的 CDatabase 对象。

virtual BOOL OpenEx( 
   LPCTSTR lpszConnectString, 
   DWORD dwOptions = 0  
);

参数

lpszConnectString
指定ODBC连接字符串。这包括数据源名称以及其他选项信息，如用户ID和密码。例如，“DSN=SQLServer_Source; UID=SA; PWD=abc123”是一个可能的连接字符串。请注意，如果通过 lpszConnectString的 NULL，数据源"对话框将提示用户选择数据源。
dwOptions
指定以下值的组合的位掩码。默认值为0，这意味着数据库中打开与编写共享，ODBC游标库DLL不会加载，并且，ODBC连接对话框将显示，只有在未生成访问的足够的信息。
- 在选件类库的此版本不支持的CDatabase::openExclusive。数据源始终中打开如共享(非独占）。目前，因此，如果指定此选项，则断言失败。
- CDatabase::openReadOnly 打开数据源为只读。
- CDatabase::useCursorLib 加载ODBC游标库DLL。（如果该驱动程序支持它们)，游标库蒙板，有效阻止使用动态集的基础ODBC驱动程序的某些功能。支持的唯一光标，则将加载游标库。是静态快照以及仅向前游标。如果计划创建记录集对象直接从 CRecordset，而无需从派生，则不应加载游标库。
- CDatabase::noOdbcDialog 不显示ODBC连接对话框，无论提供足够的连接信息。
- 始终CDatabase::forceOdbcDialog 显示ODBC连接对话框。

返回值

非零，如果连接成功生成;否则0，如果用户取消，当显示对话框请求更多连接信息。其他情况下，框架引发异常。

备注

您的数据库对象，然后才能使用该构造记录集对象之前，必须初始化。

如果您的 OpenEx 的 lpszConnectString 参数调用不包含足够的信息建立连接，ODBC驱动程序打开对话框从用户的必需信息，假定您尚未设置 CDatabase::noOdbcDialog 或 CDatabase::forceOdbcDialog 在 dwOptions 参数。当您调用 OpenEx时，您的连接字符串，lpszConnectString，在 CDatabase 对象的私有存储并通过调用 GetConnect 成员函数可用。

如果希望，可以打开您的对话框，在调用 OpenEx 从用户获得的信息，例如密码，然后添加之前，对传递到 OpenEx的连接字符串的信息。或者希望保存所传递的连接字符串，以便您可以重用它，则下次应用程序调用 CDatabase 对象的 OpenEx。

可以为登录权限还使用连接字符串(每个类型的多个级别不同的 CDatabase 对象)或表示其他数据源特定信息。有关连接字符串的更多信息，请参见 ODBC 程序员参考 中的第6章。

则，例如，DBMS宿主不可用，可能会以连接尝试可以超时。如果连接尝试失败，OpenEx 引发 CDBException。

示例

// m_dbCust is a CDatabase object embedded in a CDocument class.

// Connect the object to a read-only data source where
// the ODBC connection dialog box will always remain hidden
m_dbCust.OpenEx(_T("DSN=MFC_ODBCTest;UID=JOES"),
   CDatabase::openReadOnly | CDatabase::noOdbcDialog);