Поделиться через

  • Статья

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

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

Файлы заголовков и файлы библиотек собственного клиента SQL Server устанавливаются в следующий каталог.

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

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

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

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

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

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

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

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

ПримечаниеПримечание

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

Интерфейс OLE DB

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

#define _SQLNCLI_OLEDB_
include "sqlncli.h";
ПримечаниеПримечание

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

При создании соединения с источником данных с помощью собственного клиента SQL Server используйте в качестве строки имени поставщика «SQLNCLI10».

ODBC

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

#define _SQLNCLI_ODBC_
include "sqlncli.h";
ПримечаниеПримечание

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

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

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

Свойство

Собственный клиент SQL Server

SQL Server 2005

Собственный клиент SQL Server версии 10.0

SQL Server 2008

MDAC

Имя драйвера ODBC

Собственный клиент SQL

Собственный клиент SQL Server версии 10.0

SQL Server

Имя файла заголовка ODBC

Sqlncli.h

Sqlncli.h

Odbcss.h

DLL-библиотека драйвера ODBC

Sqlncli.dll

Sqlncl10.dll

sqlsrv32.dll

Библиотека ODBC для API-интерфейсов программы BCP

Sqlncli.lib

Sqlncli10.lib

Odbcbcp.lib

DLL-библиотека ODBC для API-интерфейсов программы BCP

Sqlncli.dll

Sqlncli10.dll

Odbcbcp.dll

Идентификатор PROGID OLE DB

SQLNCLI

SQLNCLI10

SQLOLEDB

Имя файла заголовка OLE DB

Sqlncli.h

Sqlncli.h

Sqloledb.h

DLL-библиотека поставщика OLE DB

Sqlncli.dll

Sqlncli10.dll

Sqloledb.dll

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

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

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

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

Дополнительные сведения см. в разделе, описывающем выполнение операций массового копирования (Выполнение операций массового копирования).

Журнал изменений

Обновленное содержимое

Добавлен раздел о функциях BCP и статической компоновке.