CDataSource::em aberto

Artigo
08/25/2010

Abre uma conexão com uma fonte de dados usando um CLSID, ProgID, or CEnumerator Moniker ou avisa o 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] The CLSID do provedor de dados.
pPropSet
[in] Um ponteiro para uma matriz de DBPROPSET estruturas que contém propriedades e os valores a ser definido.See Propriedade conjuntos e grupos de propriedades in the Referência do programador do OLE DB in the Windows SDK.
nPropertySets
[in] O número de DBPROPSET estruturas passado o 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.See Propriedades de inicializaçãoin the Referência do programador do OLE DB in the Windows SDK Para obter uma lista dos modos de inicialização válido. If nInitMode é zero, sem inicialização modo está incluído no conjunto de propriedades usado para em em aberto 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 os 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 dados objeto de fonte com sistema autônomo componentes de serviço no oledb32.dll; essa DLL contém a implementação de recursos de componentes de serviço, sistema autônomo o pool de recursos, inscrição de transações automáticas e assim por diante. Para obter mais informações, consulte "OLE DB Services" na referência, o OLE DB Programmer emhttps://msdn.Microsoft.com/biblioteca/padrão.asp?url=/biblioteca/en-US/OLEDB/htm/oledbole_db_services.asp?quadro=true.

Sobrecargas de método que não usam o hWnd parâmetro de em em aberto um objeto de fonte de dados sem usar os componentes de serviço em oledb32.dll. A CDataSource objeto aberto com essas sobrecargas de função não poderá utilizar qualquer funcionalidade dos componentes de serviço.

Exemplo

O código a seguir mostra como em em aberto uma fonte de dados do Jet 4.0 com modelos OLE DB.A fonte de dados do Jet você tratar sistema autônomo uma fonte de dados OLE DB.No entanto, sua telefonar a em aberto precisa de dois conjuntos de propriedades: uma para DBPROPSET_DBINIT e Outros para DBPROPSET_JETOLEDB_DBINIT, para que você possa conjunto 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

Consulte também

Referência

Classe CDataSource

Outros recursos

CDataSource membros

Compartilhar via