ITfRange：：CompareEnd 方法 (msctf.h)

ITfRange：：CompareEnd方法會將此文字範圍的結束錨點位置與另一個範圍內的錨點進行比較。

語法

HRESULT CompareEnd(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pWith,
  [in]  TfAnchor     aPos,
  [out] LONG         *plResult
);

[in] ec

[in] pWith

要與這個範圍結束錨點比較之指定範圍的指標。

[in] aPos

列舉專案，表示要與這個範圍結束錨點比較之指定 pWith 範圍的錨點。

值	意義
TF_ANCHOR_START	比較此範圍結束錨點與指定的範圍開始錨點。
TF_ANCHOR_END	比較此範圍結束錨點與指定的範圍結束錨點。

[out] plResult

這個範圍結束錨點與指定 pWith 範圍錨點之錨點之間比較結果的指標。

值	意義
-1	這個結束錨點位於指定範圍的錨點後方 (指定之範圍錨點 < 位置) 之錨點的位置。
0	這個結束錨點與指定範圍的錨點位置相同。
+1	這個結束錨點位於指定範圍的錨點之前， (指定之範圍錨點位置的這個結束錨點 > 位置) 。

這個方法可以傳回下列其中一個值。

值	描述
S_OK	此方法成功。
E_FAIL	發生未指定的錯誤。
E_INVALIDARG	一或多個參數無效。
TF_E_NOLOCK	ec參數的值是不正確 Cookie，或呼叫端沒有唯讀鎖定。

除非兩個錨點位於單一區域中，否則這個方法永遠不會傳回 0。如果呼叫端只需要有關兩個錨點是否位於相同位置的資訊，則 ITfRange：：IsEqualEnd 更有效率。

這個方法與 ITfRange：：CompareStart相同，不同之處在于此範圍的結束錨點會與另一個指定範圍的錨點進行比較。


最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	msctf.h
Dll	Msctf.dll
可轉散發套件	Windows 2000 專業版上的 TSF 1.0