Classe CManualAccessor

Representa um tipo de acessador projetado para uso avançado.

Sintaxe

class CManualAccessor : public CAccessorBase

Requisitos

Cabeçalho: atldbcli.h

Membros

Métodos

Nome	Descrição
AddBindEntry	Adiciona uma entrada de associação às colunas de saída.
AddParameterEntry	Adiciona uma entrada de parâmetro ao acessador de parâmetro.
CreateAccessor	Aloca memória para as estruturas de associação de coluna e inicializa os membros de dados da coluna.
CreateParameterAccessor	Aloca memória para as estruturas de associação de parâmetro e inicializa os membros de dados do parâmetro.

Comentários

Usando CManualAccessor, você pode especificar a associação de coluna de saída e parâmetro por chamadas de função em tempo de execução.

CManualAccessor::AddBindEntry

Adiciona uma entrada de associação às colunas de saída.

Sintaxe

void AddBindEntry(DBORDINAL nOrdinal,
   DBTYPE wType,  DBLENGTH nColumnSize,
   void* pData,
   void* pLength = NULL,
   void* pStatus = NULL) throw ();

Parâmetros

Confira DBBINDING na Referência de programador do OLE DB.

nOrdinal
[in] Número da coluna.

wType
[in] Tipos de dados.

nColumnSize
[in] Tamanho da coluna em bytes.

pData
[in] Um ponteiro para os dados armazenados de coluna no buffer.

pLength
[in] Um ponteiro para o comprimento do campo, se necessário.

pStatus
[in] Um ponteiro para a variável a ser associada ao status da coluna, se necessário.

Comentários

Para usar essa função, você deve primeiro chamar CreateAccessor. Não é possível adicionar mais entradas do que o número de colunas especificadas em CreateAccessor.

CManualAccessor::AddParameterEntry

Adiciona uma entrada de parâmetro às estruturas de entrada de parâmetro.

Sintaxe

void AddParameterEntry(DBORDINAL nOrdinal,
   DBTYPE wType,  DBLENGTH nColumnSize,
   void* pData,
   void* pLength = NULL,
   void* pStatus = NULL,
   DBPARAMIO eParamIO = DBPARAMIO_INPUT) throw ();

Parâmetros

Confira DBBINDING na Referência de programador do OLE DB.

nOrdinal
[in] Número do parâmetro.

wType
[in] Tipos de dados.

nColumnSize
[in] Tamanho da coluna em bytes.

pData
[in] Um ponteiro para os dados armazenados de coluna no buffer.

pLength
[in] Um ponteiro para o comprimento do campo, se necessário.

pStatus
[in] Um ponteiro para a variável a ser associada ao status da coluna, se necessário.

eParamIO
[in] Especifica se o parâmetro com o qual a associação está associada é um parâmetro de entrada, entrada/saída ou saída.

Comentários

Para usar essa função, você deve primeiro chamar CreateParameterAccessor.

CManualAccessor::CreateAccessor

Aloca memória para as estruturas de associação de coluna e inicializa os membros de dados da coluna.

Sintaxe

HRESULT CreateAccessor(int nBindEntries,
  void* pBuffer,
   DBLENGTH nBufferSize) throw();

Parâmetros

nBindEntries
[in] Número de colunas. Esse número deve corresponder ao número de chamadas à função CManualAccessor::AddBindEntry.

pBuffer
[in] Um ponteiro para o buffer em que as colunas de saída são armazenadas.

nBufferSize
[in] O tamanho do buffer em bytes.

Valor de retorno

Um dos valores HRESULT padrão.

Comentários

Chame essa função antes de chamar a função CManualAccessor::AddBindEntry.

CManualAccessor::CreateParameterAccessor

Aloca memória para as estruturas de associação de parâmetro e inicializa os membros de dados do parâmetro.

Sintaxe

HRESULT CreateParameterAccessor(int nBindEntries,
   void* pBuffer,
   DBLENGTH nBufferSize) throw();

Parâmetros

nBindEntries
[in] Número de colunas.

pBuffer
[in] Um ponteiro para o buffer em que as colunas de entrada são armazenadas.

nBufferSize
[in] O tamanho do buffer em bytes.

Valor de retorno

Um dos valores HRESULT padrão.

Comentários

Você deve chamar essa função antes de chamar AddParameterEntry.

Confira também

DBViewer
Modelos de consumidor OLE DB
Referência de modelos de consumidor do OLE DB
Classe CAccessor
Classe CDynamicAccessor
Classe CDynamicParameterAccessor