通过

SetFactoid 函数 (recapis.h)

指定识别器用于约束其对结果的搜索的事实。

如果输入字段为已知类型（例如输入字段包含日期），则指定一个 factoid。 在首次处理墨迹之前调用此函数。 因此，在调用 Process 函数之前，请调用 SetFactoid 函数。

语法

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

参数

hrc

识别器上下文的句柄。

cwcFactoid

pwcFactoid 中的字符数。

pwcFactoid

标识要用于识别器上下文的 factoid。 字符串不是 以 NULL 结尾的。

返回值

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

返回代码 说明
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 factoid 不是要传递给 SetFactoid 的有效值;在调用 SetFactoid 函数之前，平板电脑平台 API 在内部将 DEFAULT 转换为 NULL。

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

要求

要求 值
最低受支持的客户端 Windows XP Tablet PC Edition [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 recapis.h
DLL inkobjcore.dll

另请参阅

SetFlags 函数