CManualAccessor — Klasa

Reprezentuje typ metody dostępu przeznaczony do użycia zaawansowanego.

Składnia

class CManualAccessor : public CAccessorBase

Wymagania

Nagłówek: atldbcli.h

Elementy członkowskie

Metody

Nazwa/nazwisko	opis
AddBindEntry	Dodaje wpis powiązania do kolumn wyjściowych.
AddParameterEntry	Dodaje wpis parametru do metody dostępu parametru.
CreateAccessor	Przydziela pamięć dla struktur powiązań kolumn i inicjuje składowe danych kolumny.
CreateParameterAccessor	Przydziela pamięć dla struktur powiązania parametrów i inicjuje składowe danych parametrów.

Uwagi

Za pomocą CManualAccessorpolecenia można określić powiązanie parametru i kolumny wyjściowej przez wywołania funkcji w czasie wykonywania.

CManualAccessor::AddBindEntry

Dodaje wpis powiązania do kolumn wyjściowych.

Składnia

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

Parametry

Zobacz DBBINDING w dokumentacji programisty OLE DB.

nOrdinal
[in] Numer kolumny.

wType
[in] Typ danych.

nColumnSize
[in] Rozmiar kolumny w bajtach.

pData
[in] Wskaźnik do danych kolumny przechowywanych w buforze.

PLength
[in] Wskaźnik do długości pola, jeśli jest to wymagane.

pStatus
[in] Wskaźnik do zmiennej, która ma być powiązana ze stanem kolumny, jeśli jest to wymagane.

Uwagi

Aby użyć tej funkcji, należy najpierw wywołać funkcję CreateAccessor. Nie można dodać większej liczby wpisów niż liczba kolumn określonych w pliku CreateAccessor.

CManualAccessor::AddParameterEntry

Dodaje wpis parametru do struktur wprowadzania parametrów.

Składnia

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

Parametry

Zobacz DBBINDING w dokumentacji programisty OLE DB.

nOrdinal
[in] Numer parametru.

wType
[in] Typ danych.

nColumnSize
[in] Rozmiar kolumny w bajtach.

pData
[in] Wskaźnik do danych kolumny przechowywanych w buforze.

PLength
[in] Wskaźnik do długości pola, jeśli jest to wymagane.

pStatus
[in] Wskaźnik do zmiennej, która ma być powiązana ze stanem kolumny, jeśli jest to wymagane.

eParamIO
[in] Określa, czy parametr, z którym jest skojarzone powiązanie, jest parametrem wejściowym, wejściowym/wyjściowym lub wyjściowym.

Uwagi

Aby użyć tej funkcji, należy najpierw wywołać metodę CreateParameterAccessor.

CManualAccessor::CreateAccessor

Przydziela pamięć dla struktur powiązań kolumn i inicjuje składowe danych kolumny.

Składnia

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

Parametry

nBindEntries
[in] Liczba kolumn. Ta liczba powinna być zgodna z liczbą wywołań funkcji CManualAccessor::AddBindEntry .

pBuffer
[in] Wskaźnik do buforu, w którym są przechowywane kolumny wyjściowe.

nBufferSize
[in] Rozmiar buforu w bajtach.

Wartość zwracana

Jedna ze standardowych wartości HRESULT.

Uwagi

Wywołaj tę funkcję przed wywołaniem CManualAccessor::AddBindEntry funkcji.

CManualAccessor::CreateParameterAccessor

Przydziela pamięć dla struktur powiązania parametrów i inicjuje składowe danych parametrów.

Składnia

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

Parametry

nBindEntries
[in] Liczba kolumn.

pBuffer
[in] Wskaźnik do buforu, w którym są przechowywane kolumny wejściowe.

nBufferSize
[in] Rozmiar buforu w bajtach.

Wartość zwracana

Jedna ze standardowych wartości HRESULT.

Uwagi

Przed wywołaniem metody AddParameterEntry należy wywołać tę funkcję.

Zobacz też

DbViewer
Szablony konsumentów OLE DB
Szablony konsumentów OLE DB — dokumentacja
CAccessor, klasa
CDynamicAccessor, klasa
CDynamicParameterAccessor, klasa