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 相同，只不过此范围的结束定位点与另一个指定范围的定位点进行比较。