CDataSource::Open
Открытие соединения с источником данных с помощью CLSID, Программный ИД или моникер CEnumerator или запрашивает пользователя с диалоговым окном locator.
HRESULT Open(
const CLSID& clsid,
DBPROPSET* pPropSet = NULL,
ULONG nPropertySets = 1
) throw( );
HRESULT Open(
const CLSID& clsid,
LPCTSTR pName,
LPCTSTR pUserName = NULL,
LPCTSTR pPassword = NULL,
long nInitMode = 0
) throw( );
HRESULT Open(
LPCTSTR szProgID,
DBPROPSET* pPropSet = NULL,
ULONG nPropertySets = 1
) throw( );
HRESULT Open(
LPCTSTR szProgID,
LPCTSTR pName,
LPCTSTR pUserName = NULL,
LPCTSTR pPassword = NULL,
long nInitMode = 0
) throw( );
HRESULT Open(
const CEnumerator& enumerator,
DBPROPSET* pPropSet = NULL,
ULONG nPropertySets = 1
) throw( );
HRESULT Open(
const CEnumerator& enumerator,
LPCTSTR pName,
LPCTSTR pUserName = NULL,
LPCTSTR pPassword = NULL,
long nInitMode = 0
) throw( );
HRESULT Open(
HWND hWnd = GetActiveWindow( ),
DBPROMPTOPTIONS dwPromptOptions = DBPROMPTOPTIONS_WIZARDSHEET
) throw( );
HRESULT Open(
LPCWSTR szProgID,
DBPROPSET* pPropSet = NULL,
ULONG nPropertySets = 1
) throw( );
HRESULT Open(
LPCSTR szProgID,
LPCTSTR pName,
LPCTSTR pUserName = NULL,
LPCTSTR pPassword = NULL,
long nInitMode = 0
) throw( );
Параметры
clsid
[in] CLSID поставщика данных.pPropSet
[in] указатель на массив структур DBPROPSET, содержащий свойства и значения, используемые для задания. В разделе Наборы свойств и группы свойств справочника программиста по OLE DB в Windows SDK.nPropertySets
[in] количество структур DBPROPSET, переданных в аргумент pPropSet.pName
[in] имя базы данных, к которой выполняется подключение.pUserName
[in] имя пользователя.pPassword
[in] пароль пользователя.nInitMode
[in] режим инициализации базы данных. В разделе Свойства инициализации справочника программиста по OLE DB в Windows SDK список допустимых режимов инициализации. Если nInitMode ноль, ни режим инициализации не включается в набор свойств, которая используется для открытия подключения.szProgID
[in] идентификатор программы ".enumerator
[in] объект CEnumerator, а для получения моникер для открытия подключения, если вызывающий объект не определяет CLSID.hWnd
[in] дескриптором окна, быть родительским элементом диалогового окна. Использование перегруженную функцию, используется параметр hWnd автоматически вызывает компоненты службы; см. примечания для сведения.dwPromptOptions
[in] задает стиль диалогового окна средства поиска для отображения. В разделе Msdasc.h для возможных значений.
Возвращаемое значение
Стандартное HRESULT.
Заметки
Перегруженный метод, используется параметр hWnd будет открыт объект источника данных с компонентами службы в oledb32.dll; эта библиотека DLL содержит реализацию функций компонентов службы, таких как создание пулов ресурсов, автоматическое зачисление транзакций и т д Дополнительные сведения см. в «OLE DB Services» справочника программиста по OLE DB в https://msdn.microsoft.com/library/default.asp?url=/library/en-us/oledb/htm/oledbole_db_services.asp?frame=true.
Перегруженные версии методов, которые не используют параметр hWnd открыть объект источника данных без использования компонентов служб в oledb32.dll. Объект CDataSource, открытый с этими перегруженными функции не сможет использовать любую функциональность компонентов службы.
Пример
В следующем коде показано, как открыть источник данных Jet 4.0 с шаблонами OLE DB. Обработайте источник данных jet в качестве источника данных OLE DB. Однако в вызову Открыть требуется 2 набора свойств: один — для для DBPROPSET_DBINIT и DBPROPSET_JETOLEDB_DBINIT, чтобы можно было набор DBPROP_JETOLEDB_DATABASEPASSWORD.
CDBPropSet rgDBPropSet[2]; // Declare two property sets;
// set properties elsewhere as appropriate.
hr = m_DataSource.Open(szProgId, rgDBPropSet, 2);
Требования
Заголовок: atldbcli.h