Compartilhar via


Usando os arquivos de biblioteca e de cabeçalho do OLE DB Driver for SQL Server

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Baixar o driver do OLE DB

O cabeçalho e os arquivos de biblioteca do Driver do OLE DB para SQL Server são instalados quando a opção do SDK do Driver do OLE DB para SQL Server é selecionada durante o processo de instalação. Ao desenvolver um aplicativo, é importante copiar e instalar todos os arquivos necessários para o desenvolvimento no seu ambiente de desenvolvimento. Para obter mais informações sobre como instalar e redistribuir o Driver do OLE DB para SQL Server, confira Como instalar o Driver do OLE DB para SQL Server.

Os arquivos de biblioteca e de cabeçalho do Driver do OLE DB para SQL Server são instalados na seguinte localização:

%PROGRAM FILES%\Microsoft SQL Server\Client SDK\OLEDB<major_version><minor_version>\SDK

O arquivo de cabeçalho do Driver do OLE DB para SQL Server (msoledbsql.h) pode ser usado para adicionar a funcionalidade de acesso a dados do Driver do OLE DB para SQL Server aos seus aplicativos personalizados. O arquivo de cabeçalho do OLE DB Driver for SQL Server contém todas as definições, atributos, propriedades e interfaces necessárias para aproveitar os novos recursos introduzidos no SQL Server 2005 (9.x).

Além do arquivo de cabeçalho do Driver do OLE DB para SQL Server, há também um arquivo de biblioteca msoledbsql19.lib/msoledbsql.lib, que é a biblioteca de exportação para a funcionalidade OpenSqlFilestream.

O arquivo de cabeçalho do Driver do OLE DB para SQL Server tem compatibilidade com versões anteriores do arquivo de cabeçalho sqloledb.h usado com o MDAC (Microsoft Data Access Components), mas não contém os CLSIDs para SQLOLEDB (o Provedor OLE DB para o SQL Server fornecido com o MDAC), nem símbolos para a funcionalidade de XML (para a qual não há suporte no Driver do OLE DB para SQL Server).

Aplicativos OLE DB que usam o Driver do OLE DB para SQL Server precisam apenas fazer referência a msoledbsql.h. Se um aplicativo usar o MDAC (SQLOLEDB) e o OLE DB Driver for SQL Server, ele poderá referenciar sqloledb.h e msoledbsql.h, mas a referência a sqloledb.h precisará vir primeiro.

Usar o arquivo de cabeçalho do Driver do OLE DB para SQL Server

Para usar o arquivo de cabeçalho do Driver do OLE DB para SQL Server, você precisa usar uma instrução include no seu código de programação C/C++. As seções a seguir descrevem como fazer isso em aplicativos OLE DB.

Observação

Os arquivos de cabeçalho e de biblioteca do Driver do OLE DB para SQL Server podem ser compilados apenas usando o Visual Studio C++ 2012 ou posterior.

OLE DB

Para usar o arquivo de cabeçalho do Driver do OLE DB para SQL Server em um aplicativo OLE DB usando as seguintes linhas do código de programação:

include "msoledbsql.h";

Observação

Além disso, se o aplicativo tiver uma instrução include para sqloledb.h, a instrução include para sqlncli.h precisará vir depois dela.

Ao criar uma conexão com uma fonte de dados por meio do Driver do OLE DB 19 para SQL Server, use "MSOLEDBSQL19" como a cadeia de caracteres de nome do provedor.

Ao criar uma conexão com uma fonte de dados por meio do Driver do OLE DB 18 para SQL Server, use "MSOLEDBSQL" como a cadeia de caracteres de nome do provedor.

Propriedades e nomes de componentes por versão

Propriedade Driver do OLE DB 19 para SQL Server OLE DB Driver for SQL Server MDAC
OLE DB PROGID MSOLEDBSQL19 MSOLEDBSQL SQLOLEDB
Nome do arquivo de cabeçalho OLE DB msoledbsql.h msoledbsql.h Sqloledb.h
DLL do provedor OLE DB msoledbsql19.dll msoledbsql.dll Sqloledb.dll

Vinculação estática e funções BCP

Quando um aplicativo usa funções BCP, é importante que ele especifique na cadeia de conexão o driver da mesma versão que a fornecida com o arquivo de cabeçalho e a biblioteca usada para compilar o aplicativo.

Para obter mais informações, confira Como realizar operações de cópia em massa.

Confira também

Como criar aplicativos com o OLE DB Driver para SQL Server