Resultados de procesamiento (proveedor OLE DB de Native Client)

Se aplica a: SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)

Si se crea un objeto de conjunto de filas por la ejecución de un comando o por la generación de un objeto de conjunto de filas directamente del proveedor, el consumidor necesita recuperar y tener acceso a los datos del conjunto de filas.

Los conjuntos de filas son los objetos centrales que permiten al proveedor OLE DB de SQL Server Native Client exponer datos en formato tabular. Conceptualmente, un conjunto de filas es un conjunto de filas en las que cada fila tiene datos de columna. Un objeto de conjunto de filas expone interfaces como IRowset (contiene los métodos para capturar secuencialmente las filas del conjunto de filas), IAccessor (permite la definición de un grupo de enlaces de columna que describen la manera en que los datos tabulares se enlazan a las variables de programa del consumidor), IColumnsInfo (proporciona información sobre las columnas en el conjunto de filas) e IRowsetInfo (proporciona información sobre el conjunto de filas).

Un consumidor puede llamar al método IRowset::GetData para recuperar una fila de datos del conjunto de filas en un búfer. Antes de llamar a GetData, el consumidor describe el búfer mediante un conjunto de estructuras DBBINDING. Cada enlace describe cómo una columna en un conjunto de filas se almacena en un búfer del consumidor y contiene lo siguiente:

• Ordinal de la columna (o parámetro) al que se aplica el enlace.

• Información acerca de qué se enlaza (por ejemplo, valor de los datos, longitud de los datos y su estado de enlace).

• Información acerca de qué se desplaza en el búfer a cada una de estas partes.

• La longitud y el tipo de los valores de datos tal y como existen en el búfer del consumidor.

Al obtener datos, el proveedor usa información en cada enlace para determinar donde y cómo recuperar los datos del búfer del consumidor. Al establecer datos en el búfer del consumidor, el proveedor usa información en cada enlace para determinar donde y cómo devolver los datos en el búfer del consumidor.

Una vez especificadas las estructuras DBBINDING, se crea un descriptor de acceso (IAccessor::CreateAccessor). Un descriptor de acceso es una colección de enlaces que se usa para obtener o establecer los datos en el búfer del consumidor.

Consulte también

Crear una aplicación de proveedor OLE DB de SQL Server Native Client
Temas de procedimientos de OLE DB