PFN_MAPPINGCALLBACKPROC回调函数 (elscore.h)

项目
02/26/2024

应用程序定义的回调函数，可异步处理 MappingRecognizeText 函数生成的数据。 MAPPINGCALLBACKPROC 类型定义指向此回调函数的指针。 MappingCallbackProc 是应用程序定义的函数名称的占位符。

语法

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

void PfnMappingcallbackproc(
  [in] _MAPPING_PROPERTY_BAG *pBag,
  [in] LPVOID data,
  [in] DWORD dwDataSize,
  [in] HRESULT Result
)
{...}

参数

[in] pBag

指向包含对 MappingRecognizeText 的调用结果的MAPPING_PROPERTY_BAG结构的指针。

[in] data

指向专用应用程序数据的指针。此指针与在 MAPPING_OPTIONS 结构的 pRecognizeCallerData 成员中传递的指针相同。

[in] dwDataSize

专用应用程序数据的大小（以字节为单位）。此大小与应用程序异步调用 MappingRecognizeText 时在 MAPPING_OPTIONS 结构的 dwRecognizeCallerDataSize 成员中传递的大小相同。

[in] Result

从 MappingRecognizeText 返回代码。如果函数成功，则返回代码S_OK，否则返回代码为错误代码。

返回值

无

备注

MappingCallbackProc 函数使用 MappingRecognizeText 检索的结果。应用程序通过将回调函数的地址传递到 MAPPING_OPTIONS 结构中的 MappingRecognizeText 来注册回调函数。

应用程序应在使用 pBag 参数中的数据之前检查 Result 参数。使用属性包中的数据后，应用程序必须调用 MappingFreePropertyBag ，因为属性包可以包含指向原始文本的指针。有关属性包的详细信息，请参阅 MAPPING_PROPERTY_BAG 结构的备注。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	elscore.h