IMAPITable::SeekRowApprox Method

Article
06/30/2010

Moves the cursor to an approximate position in the table.

Syntax

HRESULT SeekRowApprox(
    ULONG ulNumerator,
    ULONG ulDenominator
);

Parameters

ulNumerator
ULONG Value of type ULONG that specifies the numerator of the fraction representing the table position.
ulDenominator
ULONG Value of type ULONG that specifies the denominator of the fraction representing the table position. ulDenominator cannot be 0.

Return Value

HRESULT

The method can return one of the following values.

Return code	Description
S_OK	The operation completed successfully.
MAPI_E_BUSY	Another operation is in progress that prevents the operation from starting. Either the operation in progress should be allowed to complete itself, or it should be stopped.

Remarks

Use IMAPITable::SeekRowApprox to move the table row cursor according to the position of a scroll box in a table view's scroll bar. For example, suppose the scroll box is positioned three-fourths of the way down the scroll bar. Use this fraction by specifying 3 for the ulNumerator parameter and 4 for the ulDenominator parameter. Accordingly, IMAPITable::SeekRowApprox places the cursor at a row which is approximately three-fourths of the table's length from its beginning.

Setting ulNumerator to 0 moves the cursor to the beginning of the table, regardless of the denominator value. If ulNumerator is greater than or equal to the ulDenominator parameter, the cursor is positioned after the last table row.

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	Internet Explorer 4.0
Header	Wabdefs.h
DLL	Wab32.dll