ITfRange::IsEqualEnd method (msctf.h)

Article
10/13/2021

The ITfRange::IsEqualStart method verifies that the end anchor of this range of text matches an anchor of another specified range.

Syntax

HRESULT IsEqualEnd(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pWith,
  [in]  TfAnchor     aPos,
  [out] BOOL         *pfEqual
);

Parameters

[in] ec

Edit cookie obtained from ITfDocumentMgr::CreateContext or ITfEditSession::DoEditSession.

[in] pWith

Pointer to a specified range in which an anchor is to be compared to this range end anchor.

[in] aPos

Enumeration element that indicates which anchor of the specified pWith range to compare with this range end anchor.

Value	Meaning
TF_ANCHOR_START	Compares this range end anchor with the specified range start anchor.
TF_ANCHOR_END	Compares this range end anchor with the specified range end anchor.

[out] pfEqual

Pointer to a Boolean value. Upon return, TRUE indicates that the specified pWith range anchor matches this range end anchor. FALSE indicates otherwise.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.
E_FAIL	An unspecified error occurred.
E_INVALIDARG	One or more parameters are invalid.
TF_E_NOLOCK	The value of the ec parameter is an invalid cookie, or the caller does not have a read-only lock.

Remarks

This method is identical to ITfRange::IsEqualStart, except that the end anchor of this range is compared to an anchor of another specified range.

This method is functionally equivalent to, but more efficient than, ITfRange::CompareEnd.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps \| UWP apps]
Minimum supported server	Windows 2000 Server [desktop apps \| UWP apps]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistributable	TSF 1.0 on Windows 2000 Professional