Использование файлов заголовков и библиотек собственного клиента SQL Server

Файлы заголовков и библиотеки SQL Server Native Client устанавливаются вместе с SQL Server. При разработке приложения важно скопировать и установить все требуемые файлы для работы среды разработки. Дополнительные сведения об установке и распространении SQL Server Native Client см. в разделе Установка SQL Server Native Client.

Файлы заголовков и библиотек SQL Server Native Client устанавливаются в следующем расположении:

%PROGRAM FILES%\Microsoft SQL Server\110\SDK

Файл заголовка SQL Server Native Client (sqlncli.h) можно использовать для добавления SQL Server Native Client функций доступа к данным в пользовательские приложения. Файл заголовка SQL Server Native Client содержит все определения, атрибуты, свойства и интерфейсы, необходимые для использования новых возможностей, представленных в SQL Server 2005 году.

В дополнение к файлу заголовка SQL Server Native Client существует также файл библиотеки sqlncli11.lib, который является библиотекой экспорта для SQL Server функции программы массового копирования (BCP) для ODBC.

Файл заголовка SQL Server Native Client обратно совместим с файлами заголовков sqloledb.h и odbcss.h, используемыми с компонентами доступа к данным Майкрософт (MDAC), но не содержит идентификаторы CLSID для SQLOLEDB (поставщик OLE DB для SQL Server включен в MDAC) или символы для функций XML (которые не поддерживаются в SQL Server Native Client).

Приложения ODBC не могут ссылаться на заголовок SQL Server Native Client (sqlncli.h) и odbcss.h в одной программе. Даже если вы не используете ни одну из функций, представленных в SQL Server 2005 году, файл заголовка SQL Server Native Client будет работать вместо старого odbcss.h.

Приложения OLE DB, использующие SQL Server Native Client поставщик OLE DB, должны ссылаться только на sqlncli.h. Если приложение использует как MDAC (SQLOLEDB), так и поставщик SQL Server Native Client OLE DB, оно может ссылаться на sqloledb.h и sqlncli.h, но ссылка на sqloledb.h должна быть первой.

Использование файла заголовка собственного клиента SQL Server

Чтобы использовать файл заголовка SQL Server Native Client, необходимо использовать include оператор в коде программирования на C/C++. В следующих подразделах описано, как это сделать для приложений OLE DB и ODBC.

Примечание

Файлы заголовков и библиотек SQL Server Native Client можно скомпилировать только с помощью Visual Studio C++ 2002 или более поздней версии.

OLE DB

Чтобы использовать файл заголовка SQL Server Native Client в приложении OLE DB, используйте следующие строки кода программирования:

#define _SQLNCLI_OLEDB_  
include "sqlncli.h";  

Примечание

Если приложение использует оба API-интерфейса (OLE DB и ODBC), то первая строка приведенного выше кода должна быть пропущена. Кроме того, если приложение содержит инструкцию include для файла sqloledb.h, то инструкция include для файла sqlncli.h должна идти после нее.

При создании подключения к источнику данных с помощью SQL Server Native Client используйте "SQLNCLI11" в качестве строки имени поставщика.

ODBC

Чтобы использовать файл заголовка SQL Server Native Client в приложении ODBC, используйте следующие строки кода программирования:

#define _SQLNCLI_ODBC_  
include "sqlncli.h";  

Примечание

Если приложение использует оба API-интерфейса (OLE DB и ODBC), то первая строка приведенного выше кода должна быть пропущена. Кроме того, если приложение содержит инструкцию #include для файла odbcss.h, ее нужно удалить.

При создании подключения к источнику данных с помощью SQL Server Native Client используйте "SQL Server Native Client 11.0" в качестве строки имени драйвера.

Имена и свойства компонентов в зависимости от версии

Свойство	собственный клиент SQL Server SQL Server 2005	Собственный клиент SQL Server версии 10.0 SQL Server 2008	SQL Server Native Client 11.0 SQL Server 2014	MDAC
Имя драйвера ODBC	Собственный клиент SQL	Собственный клиент SQL Server версии 10.0	SQL Server Native Client 11.0	SQL Server
Имя файла заголовка ODBC	Sqlncli.h	Sqlncli.h	Sqlncli.h	Odbcss.h
DLL-библиотека драйвера ODBC	Sqlncli.dll	Sqlncl10.dll	Sqlncl11.dll	sqlsrv32.dll
Библиотека ODBC для API-интерфейсов программы BCP	Sqlncli.lib	Sqlncli10.lib	Sqlncli11.lib	Odbcbcp.lib
DLL-библиотека ODBC для API-интерфейсов программы BCP	Sqlncli.dll	Sqlncli10.dll	Sqlncli11.dll	Odbcbcp.dll
Идентификатор PROGID OLE DB	SQLNCLI	SQLNCLI10	SQLNCLI11	SQLOLEDB
Имя файла заголовка OLE DB	Sqlncli.h	Sqlncli.h	Sqlncli.h	Sqloledb.h
DLL-библиотека поставщика OLE DB	Sqlncli.dll	Sqlncli10.dll	Sqlncli11.dll	Sqloledb.dll

sqlncli.h поддерживает несколько версий SQL Server Native Client с помощью макроса SQLNCLI_VER. По умолчанию SQLNCLI_VER используется последняя версия SQL Server Native Client. Чтобы создать приложение, использующее sqlncli10.dll вместо sqlncli11.dll, установите SQLNCLI_VER в значение 10.

Статическая компоновка и функции BCP

Если в приложении используются функции BCP, важно указывать в строке подключения драйвер из той же версии, которая поставлялась с файлом заголовка и библиотекой, использованными при компиляции приложения.

Например, если вы компилируете приложение с помощью SQL Server Native Client и связанного файла библиотеки (sqlncli11.lib) и файла заголовка (sqlncli.h) из \Program Files\Microsoft SQL Server\110\SDK, обязательно укажите (используя ODBC в качестве примера) "DRIVER={SQL Server Native Client 11.0}" в строке подключения.

Дополнительные сведения см. в разделе Performing Bulk Copy Operations (Выполнение операций массового копирования).

См. также:

Построение приложений с использованием SQL Server Native Client