CDatabase::OpenEx

Виртуальный OpenEx BOOL (LPCTSTR lpszConnectString, DWORD dwOptions = 0 );
Бросай (CDBException, CMemoryException);

Возвращаемое значение

Ненулевое значение, если подключение выполнено успешно; в противном случае 0, если пользователь решит отменить, когда диалоговое окно запрашивает дополнительные сведения о соединении. Во всех остальных случаях платформа создает исключения.

Параметры

lpszConnectString

Указывает, строка подключения ODBC. Это включает имя источника данных, а также другие дополнительные сведения, такие как Идентификатор пользователя и пароль. К примеру "DSN = SQLServer_Source;UID = SA;PWD = abc123 "является строкой можно подключить. Обратите внимание, что если передается значение NULL для lpszConnectString, диалоговое окно Источник данных будет запрашивать пользователя выбрать источник данных.

dwOptions

Битовая маска, которая определяет комбинацию из следующих значений. Значение по умолчанию равно 0, означает, что база данных будет открыта как совместно с доступом записи, библиотека DLL курсоров ODBC не загружается, и диалоговое окно подключение ODBC отобразит только если нет достаточной информации для подключения.

Примечания

Этот член функция вызывается для инициализации недавно построенного объекта CDatabase . Ваш объект базы данных должны быть инициализированы перед использованием его для построения объекта набора записей.

Если lpszConnectString параметр в вызове OpenEx не содержит достаточно сведений для подключения, драйвер ODBC открывает диалоговое окно для получения необходимой информации от пользователя, если вы не установили CDatabase::noOdbcDialog или CDatabase::forceOdbcDialog в параметре dwOptions . При вызове OpenEx, connect, lpszConnectString, хранится конфиденциально в объект CDatabase и доступен путем вызова функции-члена GetConnect.

Если вы хотите, прежде чем вы звоните OpenEx для получения информации от пользователя, такие как пароль и затем добавить эту информацию в строку соединения, которую передается OpenExможно открыть собственное диалоговое. Или вы можете сохранить строку подключения, вам пройти так можно повторно использовать это приложение вызывает OpenEx на объект CDatabase следующий раз.

Можно также использовать строки подключения для нескольких уровней авторизации логин (каждый на другой объект CDatabase ) или для передачи другой информации конкретного источника данных. Для получения дополнительных сведений о строк подключения, см. главу 5 в Справочник программиста ODBC SDK.

Это возможно для попытке подключения времени ожидания, если, например, СУБД хост недоступен. Если попытка соединения не удается, OpenEx создает CDBException.

Пример

/ / Внедрить объект CDatabase
/ / в вашем классе документа
CDatabase m_dbCust;

/ / Подключить объект / / чтение данных источника где
/ / диалогового окна подключение ODBC
/ / всегда будет оставаться скрытым
m_dbCust.OpenEx (_T ("DS&N = MYDATASOURCE;UID = JOES "),
 nbsp;               CDatabase::openReadOnly |
                 CDatabase::noOdbcDialog)

Обзор CDatabaseЧлены класса | Иерархическая схема

См. также CDatabase::Open, CDatabase::CDatabase, CDatabase::Close, CDBException, CRecordset::Open

Index