Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The QueryPositionmethod retrieves the current table row position of the cursor.

Note:
This method is supported for contents tables only.

Syntax 

HRESULT QueryPosition (
  ULONG FAR * 
lpulRow,
  ULONG FAR * 
lpulNumerator,
  ULONG FAR * 
lpulDenominator
);

Parameters

lpulRow

[out] Reference to the row number of the current row. The row number is zero-based; the first row in the table is zero.

lpulNumerator

[out] Not used.

lpulDenominator

[out] Not used.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

Indicates success.

Remarks

QueryPositiondetermines the current row position and returns the number of the current row. MAPI defines the current row as the next row to be read.

You can use QueryPositionto position a scroll box in a scroll bar. For example, in a table containing 100 rows, if QueryPositionreturns a value of 75 in the lpulRowparameter, you can position the scroll box 3/4 of the way across the scroll bar.

A call to QueryPositionmight involve large amounts of memory, particularly for large categorized tables. If the lpulRowparameter is set to 0xFFFFFFFF, too much memory was required for QueryPositionto determine the current row.

Requirements

Header mapidefs.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPITable

Other Resources

Messaging