Estabelecendo uma conexão com uma fonte de dados

Para acessar o provedor OLE DB do SQL Server, primeiro o consumidor deve criar uma instância de um objeto de fonte de dados chamando o método CoCreateInstance. Um CLSID (identificador de classe) exclusivo identifica cada provedor OLE DB. O identificador de classe do provedor OLE DB do SQL Server Native Client é CLSID_SQLNCLI10. Você também pode usar o símbolo SQLNCLI_CLSID, que será resolvido para o provedor OLE DB do SQL Server Native Client usado no sqlncli.h que você referencia.

O objeto da fonte de dados expõe a interface IDBProperties, que é usada pelo consumidor para fornecer informações básicas de autenticação, como o nome do servidor, o nome do banco de dados, a ID do usuário e a senha. O método IDBProperties::SetProperties é chamado para definir essas propriedades.

Se houver várias instâncias do SQL Server em execução no computador, o nome do servidor será especificado como ServerName\InstanceName.

O objeto da fonte de dados também expõe a interface IDBInitialize. Depois que as propriedades são definidas, a conexão com a fonte de dados é estabelecida chamando o método IDBInitialize::Initialize. Por exemplo:

CoCreateInstance(CLSID_SQLNCLI10, 
                 NULL, 
                 CLSCTX_INPROC_SERVER,
                 IID_IDBInitialize, 
                 (void **) &pIDBInitialize)

Esta chamada de CoCreateInstance cria um único objeto da classe associada com CLSID_SQLNCLI10 (CSLID associado com os dados e o código que serão usados para criar o objeto). IID_IDBInitialize é uma referência ao identificador da interface (IDBInitialize) a ser usada para a comunicação com o objeto.

Segue uma função de exemplo que inicializa e estabelece uma conexão com a fonte de dados.

void InitializeAndEstablishConnection() {
   // Initialize the COM library.
   CoInitialize(NULL);

   // Obtain access to the SQL Server Native Client OLE DB provider.
   hr = CoCreateInstance(CLSID_SQLNCLI10, 
                         NULL, 
                         CLSCTX_INPROC_SERVER,
                         IID_IDBInitialize, 
                         (void **) &pIDBInitialize);
   // Initialize property values needed to establish connection.
   for (i = 0 ; i < 4 ; i++) 
      VariantInit(&InitProperties[i].vValue);

   // Server name.
   // See DBPROP structure for more information on InitProperties
   InitProperties[0].dwPropertyID  = DBPROP_INIT_DATASOURCE;
   InitProperties[0].vValue.vt    = VT_BSTR;
   InitProperties[0].vValue.bstrVal= 
                     SysAllocString(L"Server");
   InitProperties[0].dwOptions    = DBPROPOPTIONS_REQUIRED;
   InitProperties[0].colid       = DB_NULLID;

   // Database.
   InitProperties[1].dwPropertyID  = DBPROP_INIT_CATALOG;
   InitProperties[1].vValue.vt    = VT_BSTR;
   InitProperties[1].vValue.bstrVal= SysAllocString(L"database");
   InitProperties[1].dwOptions    = DBPROPOPTIONS_REQUIRED;
   InitProperties[1].colid       = DB_NULLID;

   // Username (login).
   InitProperties[2].dwPropertyID  = DBPROP_AUTH_INTEGRATED;
   InitProperties[2].vValue.vt    = VT_BSTR;
   InitProperties[2].vValue.bstrVal= SysAllocString(L"SSPI");
   InitProperties[2].dwOptions    = DBPROPOPTIONS_REQUIRED;
   InitProperties[2].colid       = DB_NULLID;
   InitProperties[3].dwOptions    = DBPROPOPTIONS_REQUIRED;
   InitProperties[3].colid       = DB_NULLID;

   // Construct the DBPROPSET structure(rgInitPropSet). The 
   // DBPROPSET structure is used to pass an array of DBPROP 
   // structures (InitProperties) to the SetProperties method.
   rgInitPropSet[0].guidPropertySet = DBPROPSET_DBINIT;
   rgInitPropSet[0].cProperties   = 4;
   rgInitPropSet[0].rgProperties   = InitProperties;

   // Set initialization properties.
   hr = pIDBInitialize->QueryInterface(IID_IDBProperties, 
                           (void **)&pIDBProperties);
   hr = pIDBProperties->SetProperties(1, rgInitPropSet); 
   pIDBProperties->Release();

   // Now establish the connection to the data source.
   pIDBInitialize->Initialize();
}

Consulte também

Conceitos

Criando um aplicativo provedor OLE DB do SQL Server Native Client