Artigo
04/01/2012

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.

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.5 SQL Server 2008 R2	MDAC
Nome do driver ODBC	SQL Server 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 usa 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, não se esqueça 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.

Consulte também

Outros recursos

Criando aplicativos com o SQL Server 2008 R2 Native Client

Partilhar via