CManualAccessor (Clase)

Representa un tipo de descriptor de acceso diseñado para uso avanzado.

Sintaxis

class CManualAccessor : public CAccessorBase

Requisitos

Encabezado: atldbcli.h

Miembros

Métodos

Nombre	Descripción
AddBindEntry	Agrega una entrada de enlace a las columnas de salida.
AddParameterEntry	Agrega una entrada de parámetro al descriptor de acceso de parámetro.
CreateAccessor	Asigna memoria para las estructuras de enlace de columnas e inicializa los miembros de datos de columna.
CreateParameterAccessor	Asigna memoria para las estructuras de enlace de parámetros e inicializa los miembros de datos del parámetro.

Comentarios

Con CManualAccessor, puede especificar el parámetro y el enlace de columna de salida mediante llamadas de función en el entorno de ejecución.

CManualAccessor::AddBindEntry

Agrega una entrada de enlace a las columnas de salida.

Sintaxis

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

Parámetros

Consulte DBBINDING en la Referencia del programador de OLE DB.

nOrdinal
[in] Número de columna.

wType
[in] Tipo de datos.

nColumnSize
[in] Tamaño de columna en bytes.

pData
[in] Puntero a los datos de columna almacenados en el búfer.

pLength
[in] Puntero a la longitud del campo, si es necesario.

pStatus
[in] Puntero a la variable que se va a enlazar al estado de la columna, si es necesario.

Comentarios

Para usar esta función, primero debe llamar a CreateAccessor. No se pueden agregar más entradas que el número de columnas especificadas en CreateAccessor.

CManualAccessor::AddParameterEntry

Agrega una entrada de parámetro a las estructuras de entrada de parámetros.

Sintaxis

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

Parámetros

Consulte DBBINDING en la Referencia del programador de OLE DB.

nOrdinal
[in] Número de parámetro.

wType
[in] Tipo de datos.

nColumnSize
[in] Tamaño de columna en bytes.

pData
[in] Puntero a los datos de columna almacenados en el búfer.

pLength
[in] Puntero a la longitud del campo, si es necesario.

pStatus
[in] Puntero a la variable que se va a enlazar al estado de la columna, si es necesario.

eParamIO
[in] Especifica si el parámetro con el que está asociado el enlace es un parámetro input, input/output o output.

Comentarios

Para usar esta función, primero debe llamar a CreateParameterAccessor.

CManualAccessor::CreateAccessor

Asigna memoria para las estructuras de enlace de columnas e inicializa los miembros de datos de columna.

Sintaxis

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

Parámetros

nBindEntries
Número de columnas. Este número debe coincidir con el número de llamadas a la función CManualAccessor::AddBindEntry.

pBuffer
[in] Puntero al búfer donde se almacenan las columnas de salida.

nBufferSize
[in] Tamaño del búfer en bytes.

Valor devuelto

Uno de los valores HRESULT estándar.

Comentarios

Llame a esta función antes de llamar a la función CManualAccessor::AddBindEntry.

CManualAccessor::CreateParameterAccessor

Asigna memoria para las estructuras de enlace de parámetros e inicializa los miembros de datos del parámetro.

Sintaxis

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

Parámetros

nBindEntries
Número de columnas.

pBuffer
[in] Puntero al búfer donde se almacenan las columnas de entrada.

nBufferSize
[in] Tamaño del búfer en bytes.

Valor devuelto

Uno de los valores HRESULT estándar.

Comentarios

Debe llamar a esta función antes de llamar a AddParameterEntry.

Consulte también

DBViewer
Plantillas de consumidor OLE DB
Referencia de plantillas de consumidor OLE DB
CAccessor (Clase)
CDynamicAccessor (Clase)
CDynamicParameterAccessor (Clase)