IMAPITable：：QueryPosition
適用於：Outlook 2013 |Outlook 2016
根據小數值，擷取數據指標的目前數據表數據列位置。
HRESULT QueryPosition(
ULONG FAR * lpulRow,
ULONG FAR * lpulNumerator,
ULONG FAR * lpulDenominator
);
參數
lpulRow
[out]目前數據列數目的指標。 數據列編號是以零起始;數據表中的第一個數據列為零。
lpulNumerator
[out]識別數據表位置之分數的數值指標。
lpulDenominator
[out]識別數據表位置之分數的分母指標。 lpulDenominator 參數不可為零。
傳回值
S_OK
方法傳回 lpulRow、 lpulNumerator 和 lpulDenominator 中的有效值。
註解
IMAPITable：：QueryPosition 方法會決定目前的數據列位置，並傳回目前數據列的數目和小數值，指出其相對於數據表結尾的位置。 MAPI 會將目前的數據列定義為要讀取的下一個數據列。
實作者注意事項
您不需要針對 lpulDenominator 參數傳回數據表中的確切數據列數;它可以是近似值。
如果您無法判斷目前的數據列，請在 lpulRow 中傳回 0xFFFFFFFF 的值。
呼叫者注意事項
您可以使用 QueryPosition 將滾動盒放置在滾動條中。 例如，在包含 100 個數據列的數據表中，如果 QueryPosition 在 lpulNumerator 參數中傳回 75 的值，在 lpulDenominator 參數中傳回 100，在 lpulRow 參數中傳回 75，您可以在滾動條之間放置滾動盒 3/4。
請勿依賴 lpulDenominator 中的值是數據表中的數據列數目。 QueryPosition 無法一律識別游標所在的確切數據列。
呼叫 QueryPosition 可能牽涉到大量的記憶體，特別是針對大型分類數據表。 如果 lpulRow 參數設定為 0xFFFFFFFF， 則 QueryPosition 需要太多記憶體來判斷目前的數據列。 呼叫 IMAPITable：：SeekRowApprox 方法，將數據表定位至 lpulNumerator 和 lpulDenominator 參數所識別的數據列。 不過，如果記憶體不是因數，則不一定會預期 SeekRowApprox 會建立為 QueryPosition 中相同數據列目前的位置。