CManualAccessor 類別

發行項
08/03/2024

表示專為進階使用而設計的存取子類型。

語法

class CManualAccessor : public CAccessorBase

需求

標頭檔：atldbcli.h

成員

方法

名稱	描述
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
[in]欄號。

wType
[in]數據類型。

nColumnSize
[in]以位元組為單位的數據行大小。

pData
[in]儲存在緩衝區中的數據行數據的指標。

pLength
[in]如有需要，則為欄位長度的指標。

pStatus
[in]如果需要，要系結至數據行狀態之變數的指標。

備註

若要使用此函式，您必須先呼叫 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
[in]參數編號。

wType
[in]數據類型。

nColumnSize
[in]以位元組為單位的數據行大小。

pData
[in]儲存在緩衝區中的數據行數據的指標。

pLength
[in]如有需要，則為欄位長度的指標。

pStatus
[in]如果需要，要系結至數據行狀態之變數的指標。

eParamIO
[in]指定系結相關聯的參數是輸入、輸入/輸出或輸出參數。

備註

若要使用此函式，您必須先呼叫 CreateParameterAccessor。

CManualAccessor::CreateAccessor

配置數據行系結結構的記憶體，並初始化數據行數據成員。

語法

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

參數

nBindEntries
[in]數據行數目。此數字應該符合 CManualAccessor：：AddBindEntry 函式的呼叫數目。

pBuffer
[in]儲存輸出數據行之緩衝區的指標。

nBufferSize
[in]以位元組為單位的緩衝區大小。

傳回值

其中一個標準 HRESULT 值。

備註

呼叫此函式之前，請先呼叫此 CManualAccessor::AddBindEntry 函式。

CManualAccessor::CreateParameterAccessor

配置參數係結結構的記憶體，並初始化參數數據成員。

語法

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

參數

nBindEntries
[in]數據行數目。

pBuffer
[in]儲存輸入數據行之緩衝區的指標。

nBufferSize
[in]以位元組為單位的緩衝區大小。

傳回值

其中一個標準 HRESULT 值。

備註

您必須先呼叫此函式，才能呼叫 AddParameterEntry。

另請參閱

DBViewer
OLE DB 消費者範本
 OLE DB 消費者範本參考
 CAccessor 類別
 CDynamicAccessor 類別
 CDynamicParameterAccessor 類別

共用方式為