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 方法。