Verwenden des OLE DB-Treibers für SQL Server-Header- und -Bibliotheksdateien

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

OLE DB-Treiber herunterladen

Die Header- und Bibliotheksdateien des OLE DB-Treibers für SQL Server werden installiert, wenn die SDK-Option „OLE DB-Treiber für SQL Server“ während des Installationsprozesses ausgewählt wird. Es ist wichtig, beim Entwickeln von Anwendungen alle für die Entwicklung erforderlichen Dateien in die Entwicklungsumgebung zu kopieren. Weitere Informationen zum Installieren und erneuten Verteilen des OLE DB-Treibers für SQL Server finden Sie unter Installieren des OLE DB-Treibers für SQL Server.

Die Header- und Bibliotheksdateien des OLE DB-Treibers für SQL Server werden am folgenden Speicherort installiert:

%PROGRAM FILES%\Microsoft SQL Server\Client SDK\OLEDB<Hauptversion><Nebenversion>\SDK

Die Headerdatei für den OLE DB-Treiber für SQL Server (msoledbsql.h) kann verwendet werden, um Ihren benutzerdefinierten Anwendungen die Datenzugriffsfunktionalität des OLE DB-Treibers für SQL Server hinzuzufügen. Die Headerdatei des OLE DB-Treibers für SQL Server enthält alle Definitionen, Attribute, Eigenschaften und Schnittstellen, damit Sie die neuen, in SQL Server 2005 (9.x) eingeführten Funktionen nutzen können.

Zusätzlich zur Headerdatei für den OLE DB-Treiber für SQL Server gibt es auch eine Bibliotheksdatei „msoledbsql19.lib“/„msoledbsql.lib“, die die Exportbibliothek für die OpenSqlFilestream-Funktionalität ist.

Die Headerdatei des OLE DB-Treibers für SQL Server ist abwärtskompatibel mit der mit Microsoft Data Access Components (MDAC) verwendeten Headerdatei „sqloledb.h“, enthält aber weder die CLSIDs für SQLOLEDB (den in MDAC enthaltenen OLE DB-Anbieter für SQL Server) noch die Symbole für die XML-Funktionalität. Letztere wird nicht vom OLE DB-Treiber für SQL Server unterstützt.

OLE DB-Anwendungen, die den OLE DB-Treiber für SQL Server verwenden, müssen nur auf „msoledbsql.h“ verweisen. Wenn eine Anwendung MDAC (SQLOLEDB) und den OLE DB-Treiber für SQL Server verwendet, kann sowohl auf „sqloledb.h“ als auch auf „msoledbsql.h“ verwiesen werden, unter der Voraussetzung, dass „sqloledb.h“ zuerst angegeben wird.

Verwenden der Headerdatei des OLE DB-Treibers für SQL Server

Zum Verwenden der Headerdatei des OLE DB-Treibers für SQL Server müssen Sie eine include-Anweisung in Ihrem C-/C++-Programmcode angeben. In den folgenden Abschnitten wird dies für OLE DB-Anwendungen beschrieben.

Hinweis

Die Header- und Bibliotheksdateien des OLE DB-Treibers für SQL Server können nur mithilfe von Visual Studio C++ 2012 oder höher kompiliert werden.

OLE DB

Zum Verwenden der Headerdatei des OLE DB-Treibers für SQL Server in einer OLE DB-Anwendung geben Sie den folgenden Programmiercode ein:

include "msoledbsql.h";

Hinweis

Wenn die Anwendung eine include-Anweisung für „sqloledb.h“ aufweist, sollte die include-Anweisung für „msoledbsql.h“ nach der Anweisung für „sqloledb.h“ stehen.

Verwenden Sie zum Herstellen einer Verbindung mit einer Datenquelle über den OLE DB-Treiber 19 für SQL Server die Zeichenfolge „MSOLEDBSQL19“ als Zeichenfolge für den Anbieternamen.

Verwenden Sie zum Herstellen einer Verbindung mit einer Datenquelle über den OLE DB-Treiber 18 für SQL Server die Zeichenfolge „MSOLEDBSQL“ als Zeichenfolge für den Anbieternamen.

Komponentennamen und Eigenschaften nach Version

Eigenschaft OLE DB-Treiber 19 für SQL Server OLE DB-Treiber für SQL Server MDAC
OLE DB PROGID MSOLEDBSQL19 MSOLEDBSQL SQLOLEDB
OLE DB-Headerdateiname msoledbsql.h msoledbsql.h Sqloledb.h
OLE DB-Anbieter-DLL msoledbsql19.dll msoledbsql.dll Sqloledb.dll

Statische Verknüpfung und BCP-Funktionen

Wenn eine Anwendung BCP-Funktionen verwendet, muss in der Verbindungszeichenfolge der Treiber mit derselben Version angegeben werden, die mit der für die Anwendungskompilierung verwendeten Headerdatei und Bibliothek ausgeliefert wurde.

Weitere Informationen finden Sie unter Durchführen von Massenkopiervorgängen.

Weitere Informationen

Erstellen von Anwendungen mit dem OLE DB-Treiber für SQL Server