Partilhar via


Objetos de Fonte de Dados (OLE DB)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

Baixar driver OLE DB

O Driver OLE DB para SQL Server utiliza o termo fonte de dados para o conjunto de interfaces OLE DB usadas para estabelecer uma ligação a um armazenamento de dados, como o SQL Server. Criar uma instância do objeto fonte de dados do fornecedor é a primeira tarefa de um Driver OLE DB para consumidor SQL Server.

Cada fornecedor de OLE DB declara um identificador de classe (CLSID) para si próprio. O CLSID para o driver OLE DB para SQL Server é o CLSID_MSOLEDBSQL GUID C/C++ (o símbolo MSOLEDBSQL_CLSID resolve para o progid correto no ficheiro msoledbsql.h que refere). Com o CLSID, o consumidor utiliza a função OLE CoCreateInstance para fabricar uma instância do objeto fonte de dados.

O Driver OLE DB para SQL Server é um servidor em processo. As instâncias do OLE DB Driver para objetos SQL Server são criadas usando a macro CLSCTX_INPROC_SERVER para indicar o contexto executável.

O OLE DB Driver para o objeto fonte de dados SQL Server expõe as interfaces de inicialização OLE DB que permitem ao consumidor ligar-se a bases de dados SQL Server existentes.

Cada ligação feita através do OLE DB Driver para SQL Server define automaticamente estas opções:

  • VAMOS ANSI_WARNINGS
  • VAMOS ANSI_NULLS
  • VAMOS ANSI_PADDING
  • VAMOS ANSI_NULL_DFLT_ON
  • INICIAR QUOTED_IDENTIFIER
  • VAMOS CONCAT_OF_NULL_YIELDS_NULL

Este exemplo utiliza o macro identificador de classe para criar um Driver OLE DB para o objeto fonte de dados SQL Server e obter uma referência à sua IDBInitialize interface.

IDBInitialize*   pIDBInitialize;
HRESULT          hr;

hr = CoCreateInstance(CLSID_MSOLEDBSQL, NULL, CLSCTX_INPROC_SERVER,
    IID_IDBInitialize, (void**) &pIDBInitialize);

if (SUCCEEDED(hr))
{
    //  Perform necessary processing with the interface.
    pIDBInitialize->Uninitialize();
    pIDBInitialize->Release();
}
else
{
    // Display error from CoCreateInstance.
}

Com a criação bem-sucedida de uma instância de um Driver OLE DB para o objeto fonte de dados SQL Server, a aplicação de consumo pode continuar inicializando a fonte de dados e criando sessões. As sessões OLE DB apresentam as interfaces que permitem o acesso e manipulação de dados.

O Driver OLE DB para SQL Server faz a sua primeira ligação a uma instância específica do SQL Server como parte de uma inicialização bem-sucedida da fonte de dados. A ligação é mantida enquanto uma referência for mantida em qualquer interface de inicialização de fonte de dados, ou até que o IDBInitialize::Uninitialize método seja chamado.

Na presente seção

Ver também

Driver OLE DB para programação do SQL Server