SetWordList 函式 (recapis.h)

設定目前辨識器內容要辨識的字組清單。

語法

HRESULT SetWordList(
  HRECOCONTEXT  hrc,
  HRECOWORDLIST hwl
);

參數

hrc

辨識器內容的句柄。

hwl

要使用的辨識字清單句柄。

傳回值

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

傳回碼	描述
S_OK	成功。
E_POINTER	內容無效，或其中一個參數是無效的指標。
E_NOTIMPL	辨識器不支援此函式。
E_OUTOFMEMORY	無法配置記憶體來完成作業。
E_INVALIDARG	收到無效的自變數。
E_FAIL	方法是在呼叫 Process 之後呼叫。

備註

以第二個參數傳遞的字組清單必須已經存在。 您可以使用 MakeWordList 函式建立單字清單。 SetWordList 函式不會改變單字清單。

若要清除文字清單，請傳遞 NULL 作為第二個參數。

建議您將文字清單中的個別單字長度限制為不超過 256 個字元，並將文字清單的記憶體配置限制為不超過 128 MB。

規格需求

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

另請參閱

AddWordsToWordList 函式

MakeWordList 函式