ITfFnLMProcessor::QueryRange method (ctffunc.h)

Article
02/22/2024

Obtains the range of text that a reconversion applies to.

Syntax

HRESULT QueryRange(
  [in]  ITfRange *pRange,
  [out] ITfRange **ppNewRange,
  [out] BOOL     *pfAccepted
);

Parameters

[in] pRange

Pointer to an ITfRange object that covers all or part of the text to be reconverted.

[out] ppNewRange

Pointer to an ITfRange pointer that receives a range object that covers all of the text that can be reconverted. If none of the text covered by pRange can be reconverted, this parameters receives NULL. In this case, the method will return S_OK; the caller must verify that this parameter is not NULL before using the pointer.

This parameter is optional and can be NULL. In this case, the range is not required.

[out] pfAccepted

Pointer to a BOOL value that receives zero if none of the text covered by pRange can be reconverted or nonzero otherwise.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.
E_INVALIDARG	One or more parameters are invalid.
E_OUTOFMEMORY	A memory allocation failure occurred.

Remarks

This method is identical to ITfFnReconversion::QueryRange. When ITfFnReconversion::QueryRange is called in the text service, the text service should forward the call to this method if a language model processor is installed. If no language model processor is installed, the text service should perform its default processing.

Requirements

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