Verwenden der SQL Server Native Client Header- und Bibliotheksdateien

Die SQL Server Native Client-Header- und Bibliotheksdateien werden mit SQL Server installiert. Beim Entwickeln einer Anwendung ist es wichtig, alle erforderlichen Dateien für die Entwicklung in Ihre Entwicklungsumgebung zu kopieren und zu installieren. Weitere Informationen zum Installieren und Erneutverteilen von SQL Server Native Client finden Sie unter Installieren von SQL Server Native Client.

Die SQL Server Native Client-Header- und Bibliotheksdateien werden am folgenden Speicherort installiert:

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

Die SQL Server Native Client-Headerdatei (sqlncli.h) kann zum Hinzufügen von SQL Server Native Client-Datenzugriffsfunktionen zu Ihren benutzerdefinierten Anwendungen verwendet werden. Die SQL Server Native Client-Headerdatei enthält alle Definitionen, Attribute, Eigenschaften und Schnittstellen, die erforderlich sind, um die neuen Features zu nutzen, die in SQL Server 2005 eingeführt wurden.

Zusätzlich zur SQL Server Native Client-Headerdatei gibt es auch eine SQLncli11.lib-Bibliotheksdatei, die die Exportbibliothek für die BCP-Funktionalität (Bulk Copy Program) für SQL Server ist.

Die SQL Server Native Client-Headerdatei ist abwärtskompatibel mit den Headerdateien sqloledb.h und odbcss.h, die mit Microsoft Data Access Components (MDAC) verwendet werden, enthalten jedoch keine CLSIDs für SQLOLEDB (der OLE DB-Anbieter für SQL Server, der in MDAC enthalten ist) oder Symbole für XML-Funktionalität (die von SQL Server Native Client nicht unterstützt wird).

ODBC-Anwendungen können nicht auf den SQL Server Native Client-Header (sqlncli.h) und odbcss.h im selben Programm verweisen. Auch wenn Sie keine der in SQL Server 2005 eingeführten Features verwenden, funktioniert die SQL Server Native Client-Headerdatei anstelle der älteren odbcss.h.

OLE DB-Anwendungen, die den OLE DB-Anbieter von SQL Server Native Client verwenden, müssen nur auf sqlncli.h verweisen. Wenn eine Anwendung sowohl MDAC (SQLOLEDB) als auch den OLE DB-Anbieter des SQL Server Native Client verwendet, kann sie sowohl auf sqloledb.h als auch auf sqlncli.h verweisen, aber der Verweis auf sqloledb.h muss zuerst erfolgen.

Verwenden der NATIVEn SQL Server-Clientheaderdatei

Um die SQL Server Native Client-Headerdatei zu verwenden, müssen Sie eine include Anweisung in Ihrem C/C++-Programmiercode verwenden. In den folgenden Abschnitten wird beschrieben, wie Sie dies sowohl für OLE DB- als auch FÜR ODBC-Anwendungen tun.

Hinweis

Die SQL Server Native Client-Header- und Bibliotheksdateien können nur mit Visual Studio C++ 2002 oder höher kompiliert werden.

OLE DB

Um die SQL Server Native Client-Headerdatei in einer OLE DB-Anwendung zu verwenden, verwenden Sie die folgenden Programmiercodezeilen:

#define _SQLNCLI_OLEDB_  
include "sqlncli.h";  

Hinweis

Die erste oben gezeigte Codezeile sollte weggelassen werden, wenn sowohl die OLE DB- als auch odbc-APIs von der Anwendung verwendet werden. Wenn die Anwendung außerdem eine include Anweisung für "sqloledb.h" aufweist, muss die include Anweisung für "sqlncli.h" danach erfolgen.

Verwenden Sie beim Erstellen einer Verbindung mit einer Datenquelle über SQL Server Native Client "SQLNCLI11" als Anbieternamenzeichenfolge.

ODBC

Verwenden Sie zum Verwenden der SQL Server Native Client-Headerdatei in einer ODBC-Anwendung die folgenden Programmiercodezeilen:

#define _SQLNCLI_ODBC_  
include "sqlncli.h";  

Hinweis

Die erste oben gezeigte Codezeile sollte weggelassen werden, wenn sowohl OLE DB- als auch ODBC-APIs von der Anwendung verwendet werden. Wenn die Anwendung außerdem eine #include Anweisung für odbcss.h hat, sollte sie entfernt werden.

Verwenden Sie beim Erstellen einer Verbindung mit einer Datenquelle über SQL Server Native Client "SQL Server Native Client 11.0" als Treibernamenzeichenfolge.

Komponentennamen und Eigenschaften nach Version

Eigentum	SQL Server Native Client SQL Server 2005	SQL Server Native Client 10.0 SQL Server 2008	SQL Server Native Client 11.0 SQL Server 2014	MDAC
ODBC-Treibername	SQL Native Client	SQL Server Native Client 10.0	SQL Server Native Client 11.0	SQL Server
ODBC-Headerdateiname	Sqlncli.h	Sqlncli.h	Sqlncli.h	Odbcss.h
ODBC-Treiber-DLL	Sqlncli.dll	Sqlncl10.dll	Sqlncl11.dll	sqlsrv32.dll
ODBC-Lib-Datei für BCP-APIs	Sqlncli.lib	Sqlncli10.lib	Sqlncli11.lib	Odbcbcp.lib
ODBC-DLL für BCP-APIs	Sqlncli.dll	Sqlncli10.dll	Sqlncli11.dll	Odbcbcp.dll
OLE DB PROGID	SQLNCLI	SQLNCLI10	SQLNCLI11	SQLOLEDB
OLE DB-Headerdateiname	Sqlncli.h	Sqlncli.h	Sqlncli.h	Sqloledb.h
OLE DB-Anbieter-DLL	Sqlncli.dll	Sqlncli10.dll	Sqlncli11.dll	Sqloledb.dll

sqlncli.h unterstützt mehrere Versionen von SQL Server Native Client über das SQLNCLI_VER-Makro. Standardmäßig wird SQLNCLI_VER standardmäßig auf die neueste Version von SQL Server Native Client festgelegt. Um eine Anwendung zu erstellen, die sqlncli10.dll anstelle von sqlncli11.dllverwendet, legen Sie SQLNCLI_VER auf 10 fest.

Statische Verknüpfung und BCP-Funktionen

Wenn eine Anwendung BCP-Funktionen verwendet, ist es wichtig, dass die Anwendung in der Verbindungszeichenfolge den Treiber aus derselben Version angeben muss, die mit der Headerdatei und -bibliothek ausgeliefert wurde, die zum Kompilieren der Anwendung verwendet wurde.

Wenn Sie z. B. eine Anwendung mit SQL Server Native Client kompilieren und die zugeordnete Bibliotheksdatei (sqlncli11.lib) und die Headerdatei (sqlncli.h) aus \Program Files\Microsoft SQL Server\110\SDK, stellen Sie sicher, dass Sie in der Verbindungszeichenfolge "DRIVER={SQL Server Native Client 11.0}" angeben (mit ODBC als Beispiel).

Weitere Informationen finden Sie unter Ausführen von Massenkopievorgängen.

Siehe auch

Erstellen von Anwendungen mit SQL Server Native Client