CManualAccessor クラス

高度な使用のために設計されたアクセサー型を表します。

構文

class CManualAccessor : public CAccessorBase

要件

ヘッダー: atldbcli.h

メンバー

メソッド

Name	説明
AddBindEntry	出力列にバインド エントリを追加します。
AddParameterEntry	パラメーター アクセサーにパラメーター エントリを追加します。
CreateAccessor	列バインド構造体にメモリを割り当てて、列データ メンバーを初期化します。
CreateParameterAccessor	パラメーター バインド構造体にメモリを割り当てて、パラメーター データ メンバーを初期化します。

解説

CManualAccessor を使うと、実行時の関数呼び出しによってパラメーターと出力列のバインドを指定できます。

CManualAccessor::AddBindEntry

出力列にバインド エントリを追加します。

構文

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

パラメーター

「OLE DB プログラマーズ リファレンス」の「DBBINDING」を参照してください。

nOrdinal
[入力] 列番号。

wType
[入力]データ型。

nColumnSize
[入力] 列のサイズ (バイト単位)。

pData
[入力] バッファーに格納されている列データへのポインター。

pLength
[入力] フィールドの長さへのポインター (必要な場合)。

pStatus
[入力] 列の状態にバインドされる変数へのポインター (必要な場合)。

解説

この関数を使うには、最初に CreateAccessor を呼び出す必要があります。 CreateAccessor で指定されている列数より多くのエントリを追加することはできません。

CManualAccessor::AddParameterEntry

パラメーター エントリ構造体にパラメーター エントリを追加します。

構文

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

パラメーター

「OLE DB プログラマーズ リファレンス」の「DBBINDING」を参照してください。

nOrdinal
[入力] パラメーター番号。

wType
[入力]データ型。

nColumnSize
[入力] 列のサイズ (バイト単位)。

pData
[入力] バッファーに格納されている列データへのポインター。

pLength
[入力] フィールドの長さへのポインター (必要な場合)。

pStatus
[入力] 列の状態にバインドされる変数へのポインター (必要な場合)。

eParamIO
[入力] バインドが関連付けられるパラメーターが入力、入力/出力、出力のどのパラメーターかを指定します。

解説

この関数を使うには、最初に CreateParameterAccessor を呼び出す必要があります。

CManualAccessor::CreateAccessor

列バインド構造体にメモリを割り当てて、列データ メンバーを初期化します。

構文

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

パラメーター

nBindEntries
[入力] 列の数。 この値は、CManualAccessor::AddBindEntry 関数の呼び出し回数と一致する必要があります。

pBuffer
[入力] 出力列を格納するバッファーへのポインター。

nBufferSize
[入力] バッファーのサイズ (バイト単位)。

戻り値

標準 HRESULT 値のいずれか。

解説

CManualAccessor::AddBindEntry 関数を呼び出す前に、この関数を呼び出します。

CManualAccessor::CreateParameterAccessor

パラメーター バインド構造体にメモリを割り当てて、パラメーター データ メンバーを初期化します。

構文

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

パラメーター

nBindEntries
[入力] 列の数。

pBuffer
[入力] 入力列が格納されているバッファーへのポインター。

nBufferSize
[入力] バッファーのサイズ (バイト単位)。

戻り値

標準 HRESULT 値のいずれか。

解説

AddParameterEntry を呼び出す前に、この関数を呼び出す必要があります。

関連項目

DBViewer
OLE DB コンシューマー テンプレートに関するページ
OLE DB コンシューマー テンプレート リファレンス
CAccessor クラス
CDynamicAccessor クラス
CDynamicParameterAccessor クラス