Usando os arquivos de biblioteca e de cabeçalho do SQL Server Native Client
Os arquivos de biblioteca e de cabeçalho do SQL Server Native Client são instalados com o SQL Server. Quando você for 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 SQL Server Native Client, consulte Instalando o SQL Server Native Client.
Os arquivos de biblioteca e de cabeçalho do SQL Server Native Client são instalados no seguinte local:
%PROGRAM FILES%\Microsoft SQL Server\100\SDK
O arquivo de cabeçalho do SQL Server Native Client (sqlncli.h) pode ser usado para adicionar a funcionalidade de acesso a dados do SQL Server Native Client a seus aplicativos personalizados. O arquivo de cabeçalho do SQL Server Native Client contém todas as definições, atributos, propriedades e interfaces necessários para tirar proveito dos novos recursos introduzidos no SQL Server 2005.
Além do arquivo de cabeçalho do SQL Server Native Client, também há um arquivo de biblioteca sqlncli10.lib que é a biblioteca de exportação para a funcionalidade BCP (programa de cópia em massa) do SQL Server para ODBC.
O arquivo de cabeçalho do SQL Server Native Client tem compatibilidade com versões anteriores dos arquivos de cabeçalho sqloledb.h e odbcss.h usados com o MDAC (Microsoft Data Access Components), mas não contém o CLSIDs para SQLOLEDB (o provedor OLE DB para o SQL Server fornecido com o MDAC), nem símbolos para a funcionalidade XML (para a qual não há suporte no SQL Server Native Client).
Os aplicativos ODBC não podem referenciar o cabeçalho do SQL Server Native Client (sqlncli.h) e o odbcss.h no mesmo programa. Mesmo que você não esteja usando nenhum dos recursos introduzidos no SQL Server 2005, o arquivo de cabeçalho do SQL Server Native Client funcionará no lugar do antigo odbcss.h.
Os aplicativos OLE DB que usam o provedor OLE DB do SQL Server Native Client precisam apenas referenciar sqlncli.h. Se um aplicativo usar o MDAC (SQLOLEDB) e o provedor OLE DB do SQL Server Native Client, ele poderá referenciar sqloledb.h e sqlncli.h, mas a referência a sqloledb.h deve vir primeiro.
Usando o arquivo de cabeçalho do SQL Server Native Client
Para usar o arquivo de cabeçalho do SQL Server Native Client, você deve usar uma instrução include no seu código de programação C/C++. As seções a seguir descrevem como fazer isto para aplicativos OLE DB e ODBC.
.gif "Observação") Observação |
|---|
Os arquivos de cabeçalho e de biblioteca do SQL Server Native Client podem ser compilados apenas usando o Visual Studio C++ 2002 ou posterior. |
OLE DB
Para usar o arquivo de cabeçalho do SQL Server Native Client em um aplicativo OLE DB usando as seguintes linhas do código de programação:
#define _SQLNCLI_OLEDB_
include "sqlncli.h";
| Observação |
|---|
A primeira linha de código mostrada acima deverá ser omitida se as duas APIs OLE DB e ODBC forem usadas pelo aplicativo. Além disso, se o aplicativo tiver uma instrução include para sqloledb.h, a instrução include para sqlncli.h deverá vir depois dela. |
Ao criar uma conexão com uma fonte de dados por meio do SQL Server Native Client, use "SQLNCLI10" como a cadeia de caracteres de nome do provedor.
ODBC
Para usar o arquivo de cabeçalho do SQL Server Native Client em um aplicativo ODBC usando as seguintes linhas do código de programação:
#define _SQLNCLI_ODBC_
include "sqlncli.h";
| Observação |
|---|
A primeira linha de código mostrada acima deverá ser omitida se as duas APIs OLE DB e ODBC forem usadas pelo aplicativo. Além disso, se o aplicativo tiver uma instrução #include para odbcss.h, ela deve ser removida. |
Ao criar uma conexão com uma fonte de dados por meio do SQL Server Native Client, use "SQL Server Native Client 10.0" como a cadeia de caracteres de nome do driver.
Propriedades e nomes de componentes por versão
Propriedade |
SQL Server Native Client SQL Server 2005 |
SQL Server Native Client 10.0 SQL Server 2008 |
MDAC |
|---|---|---|---|
Nome do driver ODBC |
SQL Native Client |
SQL Server Native Client 10.0 |
SQL Server |
Nome do arquivo de cabeçalho ODBC |
Sqlncli.h |
Sqlncli.h |
Odbcss.h |
DLL do driver ODBC |
Sqlncli.dll |
Sqlncl10.dll |
sqlsrv32.dll |
Arquivo de biblioteca ODBC para APIs BCP |
Sqlncli.lib |
Sqlncli10.lib |
Odbcbcp.lib |
DLL ODBC para APIs BCP |
Sqlncli.dll |
Sqlncli10.dll |
Odbcbcp.dll |
OLE DB PROGID |
SQLNCLI |
SQLNCLI10 |
SQLOLEDB |
Nome do arquivo de cabeçalho OLE DB |
Sqlncli.h |
Sqlncli.h |
Sqloledb.h |
DLL do provedor OLE DB |
Sqlncli.dll |
Sqlncli10.dll |
Sqloledb.dll |
sqlncli.h dá suporte a várias versões do SQL Server Native Client por meio da macro SQLNCLI_VER. Por padrão, SQLNCLI_VER usa como padrão a versão mais recente do SQL Server Native Client. Para criar um aplicativo que use sqlncli.dll em vez de sqlncli10.dll, defina SQLNCLI_VER como 90.
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.
Por exemplo, se você compilar um aplicativo usando o SQL Server 2008 Native Client, e o arquivo de biblioteca associado (sqlncli10.lib) e o arquivo de cabeçalho (sqlncli.h) de \Arquivos de Programas \Microsoft SQL Server\100\SDK, assegure-se de especificar (usando o ODBC como um exemplo) “DRIVER={SQL Server Native Client 10.0}” na cadeia de conexão.
Para obter mais informações, consulte Executando Executando operações de cópia em massa.
Histórico de alterações
Conteúdo atualizado |
|---|
Adicionada seção sobre funções BCP e vinculação estática. |