Classe CManualAccessor

Rappresenta un tipo di funzione di accesso progettato per l'uso avanzato.

Sintassi

class CManualAccessor : public CAccessorBase

Requisiti

Intestazione: atldbcli.h

Membri

Metodi

Osservazioni:

Usando CManualAccessor, è possibile specificare il parametro e l'associazione di colonne di output tramite chiamate di funzione in fase di esecuzione.

CManualAccessor::AddBindEntry

Aggiunge una voce di associazione alle colonne di output.

Sintassi

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

Parametri

Vedere DBBINDING nella guida di riferimento per programmatori OLE DB.

nOrdinal
[in] Numero di colonna.

wType
[in] Tipo di dati.

nColumnSize
[in] Dimensioni delle colonne in byte.

pData
[in] Puntatore ai dati della colonna archiviati nel buffer.

pLength
[in] Puntatore alla lunghezza del campo, se necessario.

pStatus
[in] Puntatore alla variabile da associare allo stato della colonna, se necessario.

Osservazioni:

Per usare questa funzione, è prima necessario chiamare CreateAccessor. Non è possibile aggiungere più voci del numero di colonne specificate in CreateAccessor.

CManualAccessor::AddParameterEntry

Aggiunge una voce di parametro alle strutture di immissione dei parametri.

Sintassi

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

Parametri

Vedere DBBINDING nella guida di riferimento per programmatori OLE DB.

nOrdinal
[in] Numero di parametro.

wType
[in] Tipo di dati.

nColumnSize
[in] Dimensioni delle colonne in byte.

pData
[in] Puntatore ai dati della colonna archiviati nel buffer.

pLength
[in] Puntatore alla lunghezza del campo, se necessario.

pStatus
[in] Puntatore alla variabile da associare allo stato della colonna, se necessario.

eParamIO
[in] Specifica se il parametro a cui è associata l'associazione è un parametro di input, input/output o output.

Osservazioni:

Per usare questa funzione, è prima necessario chiamare CreateParameterAccessor.

CManualAccessor::CreateAccessor

Alloca la memoria per le strutture di associazione di colonne e inizializza i membri dati della colonna.

Sintassi

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

Parametri

nBindEntries
[in] Numero di colonne. Questo numero deve corrispondere al numero di chiamate alla funzione CManualAccessor::AddBindEntry .

pBuffer
[in] Puntatore al buffer in cui sono archiviate le colonne di output.

nBufferSize
[in] Dimensione del buffer in byte.

Valore restituito

Uno dei valori HRESULT standard.

Osservazioni:

Chiamare questa funzione prima di chiamare la CManualAccessor::AddBindEntry funzione .

CManualAccessor::CreateParameterAccessor

Alloca la memoria per le strutture di associazione dei parametri e inizializza i membri dati dei parametri.

Sintassi

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

Parametri

nBindEntries
[in] Numero di colonne.

pBuffer
[in] Puntatore al buffer in cui sono archiviate le colonne di input.

nBufferSize
[in] Dimensione del buffer in byte.

Valore restituito

Uno dei valori HRESULT standard.

Osservazioni:

È necessario chiamare questa funzione prima di chiamare AddParameterEntry.

Vedi anche

DBViewer
Modelli di consumer OLE DB
Riferimenti ai modelli consumer OLE DB
Classe CAccessor
Classe CDynamicAccessor
Classe CDynamicParameterAccessor