Udostępnij za pośrednictwem

CDataSource::Open

  • Artykuł

Otwiera połączenie źródła danych przy użyciu CLSID, ProgID, lub CEnumerator moniker lub monituje użytkownika z okna dialogowego lokalizatora.

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( );

Parametry

  • clsid
    [w] CLSID dostawcy danych.

  • pPropSet
    [w] Wskaźnik do tablicy DBPROPSET struktury zawierające właściwości i wartości, należy ustawić.Zobacz zestawy właściwości i właściwość grupy w OLE DB Programmer's Reference w Windows SDK.

  • nPropertySets
    [w] Liczba DBPROPSET przekazany struktur pPropSet argument.

  • pName
    [w] Nazwa bazy danych do połączenia.

  • pUserName
    [w] Nazwa użytkownika.

  • Phasło
    [w] Hasło użytkownika.

  • nInitMode
    [w] Tryb inicjowania bazy danych.Zobacz Właściwości inicjującew OLE DB Programmer's Reference w Windows SDK listę inicjowania prawidłowe tryby.Jeśli nInitMode jest zero, inicjowanie trybu jest uwzględnione w zestawie właściwości używany do otwarcia połączenia.

  • szProgID
    [w] Identyfikator programu.

  • enumerator
    [w] A CEnumerator obiektu użytego do uzyskania moniker dla otwarcia połączenia, gdy obiekt wywołujący nie określi CLSID.

  • hWnd
    [w] Dojście do okna, który ma być nadrzędne w oknie dialogowym.Za pomocą funkcji przeciążenie, który używa hWnd parametr będzie automatycznie wywoływać składniki usługi; Aby uzyskać szczegółowe informacje, zobacz Spostrzeżenia.

  • dwPromptOptions
    [w] Określa styl okno dialogowe locator, aby wyświetlić.Możliwe wartości, zobacz Msdasc.h.

Wartość zwracana

Standard HRESULT.

Uwagi

Przeciążenia metody, który używa hWnd parametr otwiera obiekt źródła danych z usługi Składniki w oledb32.dll; Ta biblioteka DLL zawiera implementacji funkcji usługi składników, takich jak pule zasobów, automatyczne umieszczanie transakcji i tak dalej.Aby uzyskać więcej informacji, zobacz "OLE DB Services" w OLE DB Programmer's Reference w https://msdn.microsoft.com/library/default.asp?url=/library/en-us/oledb/htm/oledbole_db_services.asp?frame=true.

Przeciążenia metody, które nie korzystają z hWnd parametr otwarcia obiektu źródła danych bez użycia składników usługi w oledb32.dll.A CDataSource obiekt otwarty overloads tych funkcji nie można wykorzystywać funkcjonalności usługi składników.

Przykład

Poniższy kod ilustruje sposób otwierania źródła danych aparatu Jet 4.0 OLE DB szablony.Źródło danych Jet są traktowane jako źródło danych OLE DB.Jednakże rozmowy do Otwórz potrzebuje dwóch zestawów właściwości: jeden dla DBPROPSET_DBINIT , a drugą dla DBPROPSET_JETOLEDB_DBINIT, dzięki czemu można ustawić DBPROP_JETOLEDB_DATABASEPASSWORD.

CDBPropSet rgDBPropSet[2];  // Declare two property sets;
                            // set properties elsewhere as appropriate.

hr = m_DataSource.Open(szProgId, rgDBPropSet, 2);

Wymagania

Nagłówek: atldbcli.h

Zobacz też

Informacje

Klasa CDataSource