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