MappingRecognizeText 函数 (elscore.h)

项目
08/23/2023

调用 ELS 服务来识别文本。例如，Microsoft 语言检测服务将尝试识别写入输入文本的语言。

语法

HRESULT MappingRecognizeText(
  [in]           PMAPPING_SERVICE_INFO pServiceInfo,
  [in]           LPCWSTR               pszText,
  [in]           DWORD                 dwLength,
  [in]           DWORD                 dwIndex,
  [in, optional] PMAPPING_OPTIONS      pOptions,
  [in, out]      PMAPPING_PROPERTY_BAG pbag
);

参数

[in] pServiceInfo

指向 MAPPING_SERVICE_INFO 结构的指针，该结构包含有关要用于文本识别的服务的信息。结构必须是之前调用 MappingGetServices 检索到的结构之一。此参数不能设置为 NULL。

[in] pszText

指向要识别的文本的指针。文本必须为 UTF-16，但某些服务对输入格式有其他要求。此参数不能设置为 NULL。

[in] dwLength

pszText 中指定的文本的长度（以字符为单位）。

[in] dwIndex

服务要使用的指定文本内的索引。此值应介于 0 和 dwLength-1 之间。如果应用程序要处理整个文本，则应将此参数设置为 0。

[in, optional] pOptions

指向包含影响文本识别结果和行为的选项的 MAPPING_OPTIONS 结构的指针。应用程序不必为所有结构成员指定值。此参数可以设置为 NULL 以使用默认映射选项。

[in, out] pbag

指向 MAPPING_PROPERTY_BAG 结构的指针，服务在其中存储其结果。输入时，应用程序将传递仅提供大小的结构，而其他成员设置为 0。在输出时，结构由服务在文本识别期间生成的信息填充。此参数不能设置为 NULL。

返回值

如果成功，则返回S_OK。如果函数不成功，则返回错误 HRESULT 值。

备注

要识别的文本类型取决于应用程序使用的服务类型。有关详细信息，请参阅请求文本识别。

警告pszText 和 pOptions 引用的数据必须保持有效，直到通过释放 pBag 传递的属性包结构

MappingFreePropertyBag。这是因为同步调用和异步调用

MappingRecognizeText 和 MappingDoAction 将尝试使用传递到初始数据

调用 MappingRecognizeText。

要求


最低受支持的客户端	Windows 7 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	elscore.h
Library	Elscore.lib
DLL	Elscore.dll