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)
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.