The ITfFnReconversion::QueryRange method obtains the range of text that the reconversion applies to.
Syntax
HRESULT QueryRange(
[in] ITfRange *pRange,
ITfRange **ppNewRange,
[out] BOOL *pfConvertable
);
Parameters
- pRange [in]
-
Pointer to an ITfRange object that covers all or part of the text to be reconverted.
- ppNewRange
-
[in, out] Pointer to an ITfRange pointer that receives a range object that covers all of 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, so the caller must verify that this parameter is not NULL before using the pointer.
When this method is implemented by a text service, this parameter is optional and can be NULL. In this case, the range is not required.
When the TSF manager implementation of this method is called, this parameter is not optional and cannot be NULL.
- pfConvertable [out]
-
Pointer to a BOOL value that receives zero if none of the text covered by pRange can be reconverted or non-zero otherwise.
Return Value
The method can return one of the following values.
| Value | Description |
|---|
|
S_OK
| The method was successful.
|
|
E_INVALIDARG
| One or more parameters are invalid.
|
|
E_OUTOFMEMORY
| A memory allocation failure occurred.
|
Requirements
| Client | Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation. |
|---|
| Redistributable | Requires TSF 1.0 on Windows NT 4.0, Windows 2000 Professional and Windows MeWindows 98. |
|---|
| Header | Declared in Ctffunc.idl and Ctffunc.h. |
|---|
| DLL | Requires Msctf.dll. |
|---|
See Also
ITfFnReconversion
ITfRange
Send comments about this topic to Microsoft
Build date: 12/17/2008