Compartilhar via


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çãoObservaçã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çãoObservaçã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çãoObservaçã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.