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”内容类型。
pszOutputContentType
可选。 指向字符串的指针(遵循 MIME 内容类型的格式),该字符串标识服务应检索数据的格式。 应用程序可以将此成员设置为 NULL ,让服务决定输出内容类型。
pszUILanguage
保留。
pfnRecognizeCallback
可选。 指向应用程序回调函数的指针,用于接收包含 MappingRecognizeText 函数结果的回调。 如果指定了回调函数,则文本识别将在异步模式下执行,应用程序通过回调函数获取结果。 如果文本识别是同步的,则应用程序必须将此成员设置为 NULL 。
pRecognizeCallerData
可选。 指向文本识别完成后由服务传递给回调函数的专用应用程序数据的指针。 应用程序必须将此成员设置为 NULL ,以指示没有专用应用程序数据。
dwRecognizeCallerDataSize
可选。 pRecognizeCallerData 成员指示的任何专用应用程序数据的大小(以字节为单位)。
pfnActionCallback
保留。
pActionCallerData
保留。
dwActionCallerDataSize
保留。
dwServiceFlag
可选。 服务提供程序定义以影响服务行为的专用标志。 服务可以根据需要解释此标志。
GetActionDisplayName
保留。
备注
应用程序不必填充此结构的所有成员,因为服务将 NULL 成员视为默认值。 所有未使用的成员都必须设置为 0。
必须保持有效,直到通过 释放 pBag 传递的属性包结构
MappingFreePropertyBag。 这是因为同步调用和异步调用
MappingRecognizeText 和 MappingDoAction 将尝试使用传递到初始数据
调用 MappingRecognizeText。
要求
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
标头 | elscore.h |