共用方式為


SetFactoid 函式 (recapis.h)

指定辨識器用來限制其搜尋結果的事實。

如果輸入欄位是已知的類型,您可以指定 factoid,例如輸入字段是否包含日期。 您第一次處理筆跡之前,請先呼叫此函式。 因此,呼叫 Process 函式之前,請先呼叫 SetFactoid 函式。

語法

HRESULT SetFactoid(
  HRECOCONTEXT hrc,
  ULONG        cwcFactoid,
  const WCHAR  *pwcFactoid
);

參數

hrc

辨識器內容的句柄。

cwcFactoid

pwcFactoid 中的字元數。

pwcFactoid

識別要在辨識器內容中使用的事實質。 字串不是 以 NULL 結尾。

傳回值

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

傳回碼 描述
S_OK
成功。
TPC_E_INVALID_PROPERTY
不支援指定的 factoid。
TPC_E_OUT_OF_ORDER_CALL
您必須先呼叫 SetFactoid 函式,才能呼叫 Process 函式。
E_POINTER
內容無效,或其中一個參數是無效的指標。
E_NOTIMPL
辨識器不支援此函式。
E_OUTOFMEMORY
無法配置記憶體來完成作業。
E_FAIL
發生未指定的錯誤。
E_INVALIDARG
內容包含無效的值。

備註

如需可在 cwcFactoid 參數中傳遞的事實質清單,請參閱 第 1 版支援的 Factoid。 該主題中列出的 DEFAULT 事實質不是傳遞至 SetFactoid 的有效值;在呼叫 SetFactoid 函式之前,平板電腦平臺 API 會在內部將 DEFAULT 轉換為 NULL

建議您將 factoid 字串的長度限制為不超過 32768 個字元。

規格需求

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

另請參閱

SetFlags 函式