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