Processando resultados

Se um objeto de conjunto de linhas for produzido pela execução de um comando ou pela geração de um objeto de conjunto de linhas diretamente do provedor, o consumidor precisará recuperar e acessar dados no conjunto de linhas.

Os conjuntos de linhas são os objetos centrais que permitem que o provedor OLE DB do SQL Server Native Client exponha dados no formato tabular. Conceitualmente, um conjunto de linhas é um conjunto de linhas em que cada linha tem dados de coluna. Um objeto de conjunto de linhas expõe interfaces como IRowset (contém métodos para buscar linhas do conjunto de linhas sequencialmente), IAccessor (permite a definição de um grupo de associações de colunas que descrevem a maneira como os dados tabulares são associados a variáveis de programa de consumidor), IColumnsInfo (fornece informações sobre colunas no conjunto de linhas) e IRowsetInfo (fornece informações sobre o conjunto de linhas).

Um consumidor pode chamar o método IRowset::GetData para recuperar uma linha de dados do conjunto de linhas em um buffer. Antes de GetData ser chamado, o consumidor descreve o buffer usando um conjunto de estruturas DBBINDING. Cada associação descreve como uma coluna em um conjunto de linhas é armazenada em um buffer de consumidor e contém o seguinte:

• Ordinal da coluna (ou parâmetro) à qual a associação se aplica.

• Informações sobre o que está associado (por exemplo, valor de dados, comprimento dos dados e seu status de associação).

• Informações sobre o que é deslocado no buffer para cada uma dessas partes.

• Comprimento e tipo dos valores de dados conforme eles existem no buffer do consumidor.

Ao obter os dados, o provedor usa informações em cada associação para determinar onde e como recuperar dados do buffer do consumidor. Ao definir dados no buffer do consumidor, o provedor usa informações em cada associação para determinar onde e como retornar dados no buffer do consumidor.

Depois que as estruturas DBBINDING são especificadas, um acessador é criado (IAccessor::CreateAccessor). Um acessador é uma coleção de associações e é usado para obter ou definir os dados no buffer do consumidor.

Consulte Também

Criando um aplicativo de provedor OLE DB de cliente nativo do SQL Server
Tópicos de instruções do OLE DB