CDataSource::Open
Abre uma conexão com uma fonte de dados usando um CLSID, ProgID, ou CEnumerator moniker ou solicita ao usuário com uma caixa de diálogo Localizador.
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( );
Parâmetros
clsid
[in] O CLSID do provedor de dados.pPropSet
[in] Um ponteiro para uma matriz de DBPROPSET estruturas contendo propriedades e valores a ser definido.Consulte conjuntos de propriedades e grupos de propriedade na OLE DB Programmer referência no Windows SDK.nPropertySets
[in] O número de DBPROPSET estruturas passaram a pPropSet argumento.pName
[in] O nome do banco de dados ao qual se conectar.pUserName
[in] O nome do usuário.pPassword
[in] Senha do usuário.nInitMode
[in] Modo de inicialização do banco de dados.Consulte Propriedades de inicializaçãona referência OLE DB Programmer na Windows SDK para obter uma lista de modos de inicialização válido.Se nInitMode é zero, sem inicialização modo está incluído no conjunto de propriedade usado para abrir a conexão.szProgID
[in] Um identificador de programa.enumerator
[in] A CEnumerator objeto usado para obter um identificador de origem para abrir a conexão quando o chamador não especificar um CLSID.hWnd
[in] Identificador para a janela que deve ser o pai da caixa de diálogo.Usando a sobrecarga de função que usa o hWnd parâmetro invocará automaticamente componentes de serviço; Consulte comentários para obter detalhes.dwPromptOptions
[in] Determina o estilo da caixa de diálogo localizador para exibir.Para valores possíveis, consulte Msdasc.h.
Valor de retorno
Um padrão HRESULT.
Comentários
A sobrecarga de método que usa o hWnd parâmetro abre um objeto de fonte de dados com os componentes de serviço no Oledb32. dll; Essa DLL contém a implementação de recursos de componentes de serviço, como o pool de recursos, inscrição automática em transações e assim por diante.Para obter mais informações, consulte "OLE DB Services" na referência o OLE DB Programmer em https://msdn.microsoft.com/library/default.asp?url=/library/en-us/oledb/htm/oledbole_db_services.asp?frame=true.
Sobrecargas de método que não usam o hWnd parâmetro abrir um objeto de fonte de dados sem usar os componentes de serviço no Oledb32. dll.A CDataSource objeto aberto com essas sobrecargas de função será incapaz de utilizar qualquer funcionalidade de componentes de serviço.
Exemplo
O código a seguir mostra como abrir uma fonte de dados do Jet 4.0 OLE DB modelos.A fonte de dados do Jet você tratar como uma fonte de dados OLE DB.No entanto, sua chamada para Abrir precisa de dois conjuntos de propriedades: uma para DBPROPSET_DBINIT e outro para DBPROPSET_JETOLEDB_DBINIT, para que você possa definir DBPROP_JETOLEDB_DATABASEPASSWORD.
CDBPropSet rgDBPropSet[2]; // Declare two property sets;
// set properties elsewhere as appropriate.
hr = m_DataSource.Open(szProgId, rgDBPropSet, 2);
Requisitos
Cabeçalho: atldbcli.h