MAPPING_OPTIONS 结构 (elscore.h)

包含用于文本识别的选项。 此结构中存储的值会影响 MappingRecognizeText 的行为和结果。

语法

typedef struct _MAPPING_OPTIONS {
  size_t                  Size;
  LPWSTR                  pszInputLanguage;
  LPWSTR                  pszOutputLanguage;
  LPWSTR                  pszInputScript;
  LPWSTR                  pszOutputScript;
  LPWSTR                  pszInputContentType;
  LPWSTR                  pszOutputContentType;
  LPWSTR                  pszUILanguage;
  PFN_MAPPINGCALLBACKPROC pfnRecognizeCallback;
  LPVOID                  pRecognizeCallerData;
  DWORD                   dwRecognizeCallerDataSize;
  PFN_MAPPINGCALLBACKPROC pfnActionCallback;
  LPVOID                  pActionCallerData;
  DWORD                   dwActionCallerDataSize;
  DWORD                   dwServiceFlag;
  unsigned                GetActionDisplayName : 1;
} MAPPING_OPTIONS, *PMAPPING_OPTIONS;

成员

Size

结构的大小,用于验证结构版本。 此值是必需的。

pszInputLanguage

可选。 指向输入语言字符串的指针,遵循 IETF 命名约定,该字符串标识服务应能够接受的输入语言。 应用程序可以将此成员设置为 NULL ,以指示服务可以自由地将输入解释为它支持的任何输入语言。

pszOutputLanguage

可选。 指向输出语言字符串的指针,遵循 IETF 命名约定,该字符串标识服务应能够用来生成结果的输出语言。 如果服务应决定输出语言,则应用程序可以将此成员设置为 NULL

pszInputScript

可选。 指向服务应接受的标准 Unicode 脚本名称的指针。 应用程序可以将此成员设置为 NULL ,让服务决定如何处理输入。

pszOutputScript

可选。 指向服务应用于检索结果的标准 Unicode 脚本名称的指针。 应用程序可以将此成员设置为 NULL ,让服务决定输出脚本。

pszInputContentType

可选。 指向遵循 MIME 内容类型格式的字符串的指针,该字符串标识服务在应用程序传递数据时应能够解释的格式。 内容类型的示例包括“text/plain”、“text/html”和“text/css”。 应用程序可以将此成员设置为 NULL ,以指示“text/plain”内容类型。

注意 在 Windows 7 中,ELS 服务仅支持内容类型“text/plain”。 可以在 文本媒体类型中找到内容类型规范。
 

pszOutputContentType

可选。 指向字符串的指针(遵循 MIME 内容类型的格式),该字符串标识服务应检索数据的格式。 应用程序可以将此成员设置为 NULL ,让服务决定输出内容类型。

pszUILanguage

保留。

pfnRecognizeCallback

可选。 指向应用程序回调函数的指针,用于接收包含 MappingRecognizeText 函数结果的回调。 如果指定了回调函数,则文本识别将在异步模式下执行,应用程序通过回调函数获取结果。 如果文本识别是同步的,则应用程序必须将此成员设置为 NULL

pRecognizeCallerData

可选。 指向文本识别完成后由服务传递给回调函数的专用应用程序数据的指针。 应用程序必须将此成员设置为 NULL ,以指示没有专用应用程序数据。

dwRecognizeCallerDataSize

可选。 pRecognizeCallerData 成员指示的任何专用应用程序数据的大小(以字节为单位)。

pfnActionCallback

保留。

pActionCallerData

保留。

dwActionCallerDataSize

保留。

dwServiceFlag

可选。 服务提供程序定义以影响服务行为的专用标志。 服务可以根据需要解释此标志。

注意 对于 Windows 7,没有可用的 ELS 服务支持标志。
 

GetActionDisplayName

保留。

备注

应用程序不必填充此结构的所有成员,因为服务将 NULL 成员视为默认值。 所有未使用的成员都必须设置为 0。

警告 在此结构中传递到 MappingRecognizeText 的数据,以及该调用中 pszText 参数引用的数据,

必须保持有效,直到通过 释放 pBag 传递的属性包结构

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

MappingRecognizeTextMappingDoAction 将尝试使用传递到初始数据

调用 MappingRecognizeText

 

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
标头 elscore.h

另请参阅

扩展的语言服务结构

MAPPING_DATA_RANGE

MappingRecognizeText