Freigeben über


CManualAccessor-Klasse

Stellt einen Accessortyp dar, der für die erweiterte Verwendung entwickelt wurde.

Syntax

class CManualAccessor : public CAccessorBase

Anforderungen

Header: atldbcli.h

Member

Methoden

Name Beschreibung
AddBindEntry Fügt einen Bindungseintrag zu den Ausgabespalten hinzu.
AddParameterEntry Fügt dem Parameteraccessor einen Parametereintrag hinzu.
CreateAccessor Weist Speicher für die Spaltenbindungsstrukturen zu und initialisiert die Spaltendatenmber.
CreateParameterAccessor Weist Speicher für die Parameterbindungsstrukturen zu und initialisiert die Parameterdatenmber.

Hinweise

Mithilfe von CManualAccessorLaufzeitfunktionsaufrufen können Sie die Parameter- und Ausgabespaltenbindung angeben.

CManualAccessor::AddBindEntry

Fügt einen Bindungseintrag zu den Ausgabespalten hinzu.

Syntax

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

Parameter

Siehe DBBINDING in der OLE DB-Programmierreferenz.

nOrdinal
[in] Spaltennummer.

wType
[in] Datentyp.

nColumnSize
[in] Spaltengröße in Byte.

pData
[in] Ein Zeiger auf die im Puffer gespeicherten Spaltendaten.

pLength
[in] Ein Zeiger auf die Feldlänge, falls erforderlich.

pStatus
[in] Ein Zeiger auf die Variable, die bei Bedarf an den Spaltenstatus gebunden werden soll.

Hinweise

Um diese Funktion zu verwenden, müssen Sie zuerst CreateAccessor aufrufen. Sie können nicht mehr Einträge als die Anzahl der spalten hinzufügen, die in CreateAccessor.

CManualAccessor::AddParameterEntry

Fügt einen Parametereintrag zu den Parametereintragsstrukturen hinzu.

Syntax

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

Parameter

Siehe DBBINDING in der OLE DB-Programmierreferenz.

nOrdinal
[in] Parameternummer.

wType
[in] Datentyp.

nColumnSize
[in] Spaltengröße in Byte.

pData
[in] Ein Zeiger auf die im Puffer gespeicherten Spaltendaten.

pLength
[in] Ein Zeiger auf die Feldlänge, falls erforderlich.

pStatus
[in] Ein Zeiger auf die Variable, die bei Bedarf an den Spaltenstatus gebunden werden soll.

eParamIO
[in] Gibt an, ob der Parameter, dem die Bindung zugeordnet ist, ein Eingabe-/Ausgabeparameter ist.

Hinweise

Um diese Funktion zu verwenden, müssen Sie zuerst CreateParameterAccessor aufrufen.

CManualAccessor::CreateAccessor

Weist Speicher für die Spaltenbindungsstrukturen zu und initialisiert die Spaltendatenmber.

Syntax

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

Parameter

nBindEntries
[in] Anzahl der Spalten. Diese Nummer sollte mit der Anzahl der Aufrufe der CManualAccessor::AddBindEntry-Funktion übereinstimmen.

pBuffer
[in] Ein Zeiger auf den Puffer, in dem die Ausgabespalten gespeichert sind.

nBufferSize
[in] Die Größe des Puffers in Byte.

Rückgabewert

Einer der HRESULT-Standardwerte.

Hinweise

Rufen Sie diese Funktion auf, bevor Sie die CManualAccessor::AddBindEntry Funktion aufrufen.

CManualAccessor::CreateParameterAccessor

Weist Speicher für die Parameterbindungsstrukturen zu und initialisiert die Parameterdatenmber.

Syntax

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

Parameter

nBindEntries
[in] Anzahl der Spalten.

pBuffer
[in] Ein Zeiger auf den Puffer, in dem die Eingabespalten gespeichert sind.

nBufferSize
[in] Die Größe des Puffers in Byte.

Rückgabewert

Einer der HRESULT-Standardwerte.

Hinweise

Sie müssen diese Funktion aufrufen, bevor Sie AddParameterEntry aufrufen.

Siehe auch

DBViewer
OLE DB-Consumervorlagen
Referenz der OLE DB-Consumervorlagen
CAccessor-Klasse
CDynamicAccessor-Klasse
CDynamicParameterAccessor-Klasse