Sdílet prostřednictvím

CDataSource::Open

  • Článek

Naváže připojení ke zdroji dat pomocí CLSID, ProgID, nebo CEnumerator zástupný název nebo výzvu s dialogovým oknem 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, které mají být nastaveny.Viz sady vlastností a vlastností skupiny v OLE DB Programmer's Reference v Windows SDK.

  • nPropertySets
    [v] Počet DBPROPSET struktury předán 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 objekt, který slouží k získání zástupný název pro otevírání připojení při volající neurčí CLSID.

  • hWnd
    [v] Popisovač okna musí být nadřazeného dialogu.Pomocí funkce přetížení, který používá hWnd parametru automaticky vyvolá součásti služby; Další informace naleznete v oddílu Poznámky.

  • dwPromptOptions
    [v] Určuje styl zobrazení dialogového okna locator.Možné hodnoty naleznete v tématu Msdasc.h.

Vrácená hodnota

Standardní 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 obsahuje implementaci funkcí součásti služby jako fond zdrojů, automatický zápis do transakce atd.Další informace naleznete v tématu "OLE DB služby" v OLE DB Programmer's Reference 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 CdataaSource objekt otevřen s Tato přetížení 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 databázového stroje Jet 4.0 pomocí šablon technologie OLE DB.Zdroj dat Jet se považovat za zdroj dat OLE DB.Však volání otevřených potřebuje dvě sady vlastností: jeden pro DBPROPSET_DBINIT a druhou 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í: také atldbcli.h

Viz také

Referenční dokumentace

CDataSource – třída