Uso del controlador OLE DB para los archivos de encabezado y biblioteca de SQL Server

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Descargar controlador OLE DB

Los archivos de encabezado y biblioteca para OLE DB Driver for SQL Server se instalan cuando se selecciona la opción del SDK de OLE DB Driver for SQL Server durante el proceso de instalación. Al desarrollar una aplicación, es importante copiar e instalar todos los archivos necesarios para el desarrollo en el entorno de desarrollo. Para más información acerca de la instalación y redistribución de OLE DB Driver for SQL Server, consulte Instalación del controlador OLE DB Driver for SQL Server.

Los archivos de encabezado y de biblioteca para OLE DB Driver for SQL Server se instalan en la ubicación siguiente:

%PROGRAM FILES%\Microsoft SQL Server\Client SDK\OLEDB<versión_principal><versión_secundaria>\SDK

El archivo de encabezado de OLE DB Driver for SQL Server (msoledbsql.h) se puede usar para agregar la funcionalidad de acceso a datos de OLE DB Driver for SQL Server a las aplicaciones personalizadas. El archivo de encabezado del controlador de OLE DB para SQL Server contiene todas las definiciones, atributos, propiedades e interfaces necesarios para aprovechar las nuevas características introducidas en SQL Server 2005 (9.x).

Además del archivo de encabezado de OLE DB Driver for SQL Server, también hay un archivo de biblioteca msoledbsql19.lib/msoledbsql.lib, que es la biblioteca de exportación para la funcionalidad OpenSqlFilestream.

El archivo de encabezado de OLE DB Driver for SQL Server es compatible con las versiones anteriores del archivo de encabezado sqloledb.h utilizados con Microsoft Data Access Components (MDAC), pero no contiene CLSID para SQLOLEDB (el proveedor OLE DB de SQL Server incluido con MDAC) ni los símbolos de la funcionalidad XML (que OLE DB Driver for SQL Server no admite).

Las aplicaciones OLE DB que usan OLE DB Driver for SQL Server solo necesitan hacer referencia a msoledbsql.h. Si una aplicación utiliza MDAC (SQLOLEDB) y el proveedor OLE DB del controlador de OLE DB para SQL Server, puede hacer referencia a sqloledb.h y a msoledbsql.h, pero la referencia a sqloledb.h debe aparecer en primer lugar.

Uso del archivo de encabezado de OLE DB Driver for SQL Server

Para usar el archivo de encabezado de OLE DB Driver for SQL Server, debe utilizar una instrucción include en el código de programación en C/C++. En las secciones siguientes se describe cómo solucionar problemas de aplicaciones de OLE DB.

Nota

Los archivos de encabezado y de biblioteca de OLE DB Driver for SQL Server solo se pueden compilar utilizando Visual Studio C++ 2012 o posterior.

OLE DB

Para utilizar el archivo de encabezado de OLE DB Driver for SQL Server en una aplicación OLE DB, con las líneas siguientes de código de programación:

include "msoledbsql.h";

Nota

Si la aplicación tiene una instrucción include para sqloledb.h, la instrucción include para sqlncli.h debe venir detrás de esta.

Al crear una conexión a un origen de datos mediante OLE DB Driver 19 for SQL Server, utilice "MSOLEDBSQL19" como la cadena de nombre de proveedor.

Al crear una conexión a un origen de datos mediante OLE DB Driver 18 for SQL Server, utilice "MSOLEDBSQL" como la cadena de nombre de proveedor.

Nombres de componente y propiedades por versión

Propiedad	OLE DB Driver 19 for SQL Server	Controlador OLE DB para SQL Server	MDAC
PROGID de OLE DB	MSOLEDBSQL19	MSOLEDBSQL	SQLOLEDB
Nombre de archivo de encabezado de OLE DB	msoledbsql.h	msoledbsql.h	Sqloledb.h
DLL del proveedor OLE DB	msoledbsql19.dll	msoledbsql.dll	Sqloledb.dll

Vinculación estática y funciones BCP

Cuando una aplicación utiliza funciones BCP, es importante que la aplicación especifique en la cadena de conexión el controlador de la misma versión que se envió con el archivo de encabezados y la biblioteca utilizada para compilar la aplicación.

Para más información, consulte Realización de operaciones de copia masiva.

Consulte también

Compilación de aplicaciones con el controlador OLE DB para SQL Server