IMAPITable::SeekRowApprox

适用于:Outlook 2013 | Outlook 2016

将光标移动到表中的大致小数部分位置。

HRESULT SeekRowApprox(
ULONG ulNumerator,
ULONG ulDenominator
);

参数

ulNumerator

[in]指向表示表位置的分数的分子的指针。 如果 ulNumerator 参数为零,则游标将定位在表的开头,而不考虑分母值。 如果 ulNumerator 等于 ulDenominator 参数,则光标位于最后一个表行之后。

ulDenominator

[in]指向表示表位置的分数的分母的指针。 ulDenominator 参数不能为零。

返回值

S_OK

查找操作成功。

MAPI_E_BUSY

另一个操作正在进行中,该操作阻止行查找操作启动。 应允许正在进行的操作完成,或者应停止该操作。

备注

调用 IMAPITable::SeekRowApprox 方法后,游标在表中的位置是试探分数,可能不精确。 例如,某些提供程序可能会在二元树的顶部实现表,出于性能原因,将表的中间点视为树的顶部。 如果树不均衡,则使用的中间点可能不是表的中间点。

给调用方的说明

调用 SeekRowApprox 为滚动条实现提供数据。 例如,如果用户在滚动条上放置滚动框 2/3,则可以通过调用 SeekRowApprox 并使用 ulNumeratorulDenominator 传入等效的小数部分值来为该操作建模。 SeekRowApprox 搜索始终是表开头的绝对搜索。 若要移动到表的末尾, ulNumeratorulDenominator 中的值必须相同。

使用适合的任何数字方案。 也就是说,要查找表格中途的位置,可以指定 1/2、10/20 或 50/100。

另请参阅

IMAPITable : IUnknown