getUnicodeRanges 函式 (recapis.h)

傳回辨識器支援的 Unicode 點範圍。

語法

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

參數

hrec

辨識器的句柄。

pcRanges

在輸入時， 可以保存之類型 緩衝區的範圍數目。 輸出時， 會包含於其上的範圍 數目。

pcr

CHARACTER_RANGE 結構的陣列。 每個結構都包含辨識器支援的 Unicode 點範圍。 陣列的順序是任意的。 若要判斷緩衝區的必要大小，請將 其 設定為 NULL;使用範圍數目來配置 回應 緩衝區。

傳回值

此函式可以傳回下列其中一個值。

傳回碼	描述
S_OK	成功。
E_POINTER	其中一個參數是無效的指標。
TPC_E_INSUFFICIENT_BUFFER	此標識元緩衝區太小。
E_FAIL	發生未指定的錯誤。
E_INVALIDARG	收到無效的自變數。
E_OUTOFMEMORY	記憶體不足。

備註

此函式是選擇性的。

某些辨識器不支援這項功能，但仍可能包含 GetUnicodeRanges 函式函式 。 對於這類辨識器， GetUnicodeRanges 函 式會傳回E_NOTIMPL。

若要控制特定辨識器內容所使用的 Unicode 範圍，請使用 GetEnabledUnicodeRanges 和 SetEnabledUnicodeRanges 函 式。 這些範圍限制為 GetUnicodeRanges 所傳回之範圍的子集。

Microsoft 手勢辨識器會使用來自0xF000的 Unicode 字元來0xF0FF。 此範圍中的每個單一 Unicode 值都代表單一手勢。 如需手勢的 Unicode 值完整清單，請參閱 手勢的 Unicode 範圍值。

規格需求

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	recapis.h
Dll	inkobjcore.dll

另請參閱

GetEnabledUnicodeRanges 函式

SetEnabledUnicodeRanges 函式