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 並使用 ulNumerator 和 ulDenominator 傳入對等的小數值,來建立該動作的模型。 SeekRowApprox 搜尋一律是從數據表開頭開始的絕對搜尋。 若要移至數據表結尾, ulNumerator 和 ulDenominator 中的值必須相同。
使用任何適當的數位配置。 也就是說,若要搜尋數據表中間的位置,您可以指定 1/2、10/20 或 50/100。