Sdílet prostřednictvím

CDataSource::Open

  • Článek

Vytvoří připojení ke zdroji dat pomocí CLSID, ProgID, nebo CEnumerator zástupný název nebo vyzve uživatele dialogové okno 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( );

Parametry

  • clsid
    [v] CLSID zprostředkovatele dat.

  • pPropSet
    [v] Ukazatel na pole DBPROPSET struktury obsahující vlastnosti a hodnoty nastavení.Viz sady vlastností a vlastností skupiny v OLE DB Programmer's Reference v Windows SDK.

  • nPropertySets
    [v] Počet DBPROPSET struktury předána pPropSet argument.

  • pName
    [v] Název databáze, ke kterému se chcete připojit.

  • pUserName
    [v] Jméno uživatele.

  • pPassword
    [v] Heslo uživatele.

  • nInitMode
    [v] Režim inicializace databáze.Viz Inicializační vlastnostiv OLE DB Programmer's Reference v Windows SDK seznam inicializace platné režimy.Pokud nInitMode je nula, žádná inicializace režimu je součástí sady vlastností slouží k otevření připojení.

  • szProgID
    [v] Identifikátor programu.

  • enumerator
    [v] A CEnumerator k získání zástupný název pro otevírání připojení při neurčuje volající objekt CLSID.

  • hWnd
    [v] Popisovač okna, které má být nadřazené dialogové okno.Pomocí funkce přetížení, který používá hWnd parametru automaticky vyvolají součásti služby; Podrobnosti naleznete v části poznámky.

  • dwPromptOptions
    [v] Určuje styl locator dialogové okno zobrazit.Možné hodnoty naleznete v tématu Msdasc.h.

Vrácená hodnota

Standard HRESULT.

Poznámky

Přetížení metody, která používá hWnd parametr otevře objekt zdroje dat pomocí služby komponent v oledb32.dll; Tato knihovna DLL obsahuje implementaci funkcí součásti služby jako fond zdrojů, automatický zápis do transakce a tak dále.Další informace naleznete v tématu "Služby OLE DB" OLE DB programátora odkazu na https://msdn.microsoft.com/library/default.asp?url=/library/en-us/oledb/htm/oledbole_db_services.asp?frame=true.

Přetížení metody, které nepoužívají hWnd parametr otevřít objekt zdroje dat bez použití služby komponent v oledb32.dll.A CDataSource objekt otevřen s přetížení tyto funkce nebudou moci využívat všechny funkce součásti služby.

Příklad

Následující kód ukazuje, jak otevřít zdroj dat Jet 4.0 OLE DB šablony.Zdroj dat Jet se zachází jako zdroj dat OLE DB.Však volání otevřených potřebuje dvě sady vlastností: jeden pro DBPROPSET_DBINIT a druhý pro DBPROPSET_JETOLEDB_DBINIT, takže můžete nastavit DBPROP_JETOLEDB_DATABASEPASSWORD.

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

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

Požadavky

Záhlaví: atldbcli.h

Viz také

Referenční dokumentace

Třída CDataSource