Utilisation des fichiers bibliothèques et d’en-tête OLE DB Driver pour SQL Server
S’applique à : 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Les fichiers bibliothèque et d’en-tête OLE DB Driver pour SQL Server sont installés quand l’option SDK OLE DB Driver pour SQL Server est sélectionnée pendant le processus d’installation. Pendant le développement d’une application, copiez et installez tous les fichiers nécessaires pour le développement sur votre environnement de développement. Pour plus d’informations sur l’installation et la redistribution OLE DB Driver pour SQL Server, consultez Installation d’OLE DB Driver pour SQL Server.
Les fichiers bibliothèque et d’en-tête d’OLE DB Driver pour SQL Server sont installés à l’emplacement suivant :
%PROGRAM FILES%\Microsoft SQL Server\Client SDK\OLEDB<major_version><minor_version>\SDK
Le fichier OLE DB Driver pour SQL Server (msoledbsql.h) peut être utilisé pour ajouter la fonctionnalité d'accès aux données OLE DB Driver pour SQL Server à vos applications personnalisées. Le fichier d’en-tête OLE DB Driver pour SQL Server contient l’ensemble des définitions, attributs, propriétés et interfaces nécessaires pour tirer parti des nouvelles fonctionnalités introduites dans SQL Server 2005 (9.x).
En plus du fichier d’en-tête OLE DB Driver pour SQL Server, il y a également un fichier bibliothèque msoledbsql19.lib/msoledbsql.lib, qui est la bibliothèque d’exportation de la fonctionnalité OpenSqlFilestream.
Le fichier d’en-tête OLE DB Driver pour SQL Server offre une compatibilité descendante avec le fichier d’en-tête sqloledb.h utilisé avec Microsoft Data Access Components (MDAC), mais ne contient pas les CLSID pour SQLOLEDB (le fournisseur OLE DB pour SQL Server inclus avec MDAC) ni les symboles pour la fonctionnalité XML (non prise en charge par OLE DB Driver pour SQL Server).
Les applications OLE DB qui utilisent OLE DB Driver pour SQL Server doivent uniquement référencer msoledbsql.h. Si une application utilise MDAC (SQLOLEDB) et OLE DB Driver pour SQL Server, elle peut faire référence à sqloledb.h et msoledbsql.h, mais la référence à sqloledb.h doit être placée en premier.
Utilisation du fichier d'en-tête OLE DB Driver pour SQL Server
Pour utiliser le fichier d'en-tête OLE DB Driver pour SQL Server, vous devez utiliser une instruction include dans votre code de programmation C/C++. Les sections suivantes expliquent comment procéder dans les applications OLE DB.
Notes
Les fichiers bibliothèque et d'en-tête OLE DB Driver pour SQL Server ne peuvent être compilés qu'à l'aide de Visual Studio C++ 2012 ou version ultérieure.
OLE DB
Pour utiliser le fichier d'en-tête OLE DB Driver pour SQL Server dans une application OLE DB, à l'aide des lignes de code de programmation suivantes :
include "msoledbsql.h";
Notes
Si l'application possède une instruction include pour sqloledb.h, l'instruction include pour sqlncli.h doit venir après elle.
Quand vous créez une connexion à une source de données avec OLE DB Driver 19 pour SQL Server, utilisez « MSOLEDBSQL19 » comme chaîne du nom de fournisseur.
Quand vous créez une connexion à une source de données avec OLE DB Driver 18 pour SQL Server, utilisez « MSOLEDBSQL » comme chaîne du nom de fournisseur.
Noms et propriétés des composants par version
| Propriété | OLE DB Driver 19 pour SQL Server | OLE DB Driver pour SQL Server | MDAC |
|---|---|---|---|
| PROGID pour OLE DB | MSOLEDBSQL19 | MSOLEDBSQL | SQLOLEDB |
| Nom du fichier d'en-tête OLE DB | msoledbsql.h | msoledbsql.h | Sqloledb.h |
| DLL du fournisseur OLE DB | msoledbsql19.dll | msoledbsql.dll | Sqloledb.dll |
Liaison statique et fonctions BCP
Quand une application utilise des fonctions BCP, il est important pour l’application de spécifier dans la chaîne de connexion le pilote de la même version fourni avec le fichier d’en-tête et la bibliothèque utilisés pour compiler l’application.
Pour plus d’informations, consultez Exécution d'opérations de copie en bloc.