PFN_MAPPINGCALLBACKPROC回呼函式 (elscore.h)
應用程式定義的回呼函式，可異步處理 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 來註冊回呼函式。
應用程式應該先檢查 Result 參數，再使用 pBag 參數中的數據。 使用屬性包中的數據完成時，應用程式必須呼叫 MappingFreePropertyBag ，因為屬性包可以包含原始文字中的指標。 如需屬性包的詳細資訊，請參閱 MAPPING_PROPERTY_BAG 結構的備註。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | elscore.h |