SetFactoid 函数 (recapis.h)

指定识别器用来限制其对结果的搜索的事实。

如果输入字段属于已知类型,则指定事实数据表,例如输入字段是否包含日期。 在首次处理墨迹之前调用此函数。 因此,在调用 Process 函数之前调用 SetFactoid 函数。

Syntax

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

参数

hrc

识别器上下文的句柄。

cwcFactoid

pwcFactoid 中的字符数。

pwcFactoid

标识在识别器上下文中使用的事实数据表。 字符串不以 NULL 结尾。

返回值

此函数可以返回其中一个值。

返回代码 Description
S_OK
成功。
TPC_E_INVALID_PROPERTY
不支持指定的 factoid。
TPC_E_OUT_OF_ORDER_CALL
在调用 Process 函数之前,必须调用 SetFactoid 函数。
E_POINTER
上下文无效,或者其中一个参数是无效指针。
E_NOTIMPL
识别器不支持此函数。
E_OUTOFMEMORY
无法分配内存以完成作。
E_FAIL
发生未指定的错误。
E_INVALIDARG
上下文包含无效值。

注解

有关可在 cwcFactoid 参数中传递的 factoid 列表,请参阅 版本 1 中支持的 Factoid。 该主题中列出的 DEFAULT 事实数据表不是传递给 SetFactoid 的有效值;在调用 SetFactoid 函数之前,平板电脑平台 API 在内部将 DEFAULT 转换为 NULL

建议将 factoid 字符串的长度限制为不超过 32768 个字符。

要求

Requirement 价值
最低支持的客户端 Windows XP Tablet PC Edition [桌面应用 |UWP 应用]
支持的最低服务器 无受支持的版本
目标平台 Windows操作系统
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

另请参阅

SetFlags 函数