GetBestResultString 函数 (recapis.h)

检索最佳结果字符串。

Syntax

HRESULT GetBestResultString(
  HRECOCONTEXT hrc,
  ULONG        *pcSize,
  WCHAR        *pwcBestResult
);

参数

hrc

识别器上下文的句柄。

pcSize

在输入时, pwcBestResult 缓冲区可以保留的字符数。 输出时, pwcBestResult 缓冲区包含的字符数。 如果 pwcBestResultNULL,该函数将返回用于分配 pwcBestResult 缓冲区的缓冲区所需的大小。

pwcBestResult

识别结果。 如果缓冲区太小,函数将截断字符串。 字符串不以 NULL 结尾。 若要确定缓冲区的所需大小,请将 pwcBestResult 设置为 NULL;使用 pcSize 分配 pwcBestResult 缓冲区。

返回值

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

返回代码 Description
S_OK
成功。

对于拉丁语和东亚识别器,此结果与 pwcBestResult 中的空字符串结合使用意味着不存在识别结果。

TPC_S_TRUNCATED
字符串将被截断,以适应 pwcBestResult 缓冲区。
E_POINTER
其中一个参数是无效的指针。
E_FAIL
发生未指定的错误。
E_INVALIDARG
收到无效参数。
E_UNEXPECTED
意外的参数或属性类型。
TPC_E_NOT_RELEVANT
识别器上下文不包含结果。

要求

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