共用方式為


ITableData::HrEnumRow

適用於:Outlook 2013 |Outlook 2016

根據數據列在數據表中的位置來擷取數據列。

HRESULT HrEnumRow(
  ULONG ulRowNumber,
  LPSRow FAR * lppSRow
);

參數

ulRowNumber

[in]要傳回屬性的數據列數目。 ulRowNumber 參數中的值可以是 0 的任何值,這表示數據表中的第一個數據列,到 n - 1,表示數據表中的最後一個數據列。

lppSRow

[out]描述目標數據列 之 SRow 結構指標的指標。

傳回值

S_OK

已成功擷取數據列,或 ulRowNumber 參數所指定之數據列編號的數據列不存在。

註解

ITableData::HrEnumRow 方法會根據循序數位擷取數據列。 此數位表示插入 (0 的順序表示第一個數據列,而數據列數減 1 表示最後一個數據列) 。 MAPI 會針對數據表數據物件的存留期,維持數據列插入的這個時間順序。

如果 ulRowNumber 中指定的數位未對應至數據表中的數據列, HrEnumRow 會傳回 S_OK,並將 lppSRow 參數設定為 NULL。

MAPI 會在建立資料表數據物件時,使用MAPIAllocateBuffer函式為傳回的 SRow 結構配置記憶體。 呼叫端必須藉由呼叫 MAPIFreeBuffer 函式來釋放此記憶體。

若要依數據表的插入順序從數據表擷取數據列,數據表數據對象用戶會呼叫 HrEnumRow 方法。

另請參閱

MAPIAllocateBuffer

MAPIFreeBuffer

SRow

ITableData:IUnknown