PFN_MAPPINGCALLBACKPROC Rückruffunktion (elscore.h)

Artikel
02/26/2024

Eine anwendungsdefinierte Rückruffunktion, die von der MappingRecognizeText-Funktion erzeugte Daten asynchron verarbeitet. Der MAPPINGCALLBACKPROC-Typ definiert einen Zeiger auf diese Rückruffunktion. MappingCallbackProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

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

Parameter

[in] pBag

Zeiger auf eine MAPPING_PROPERTY_BAG-Struktur , die die Ergebnisse des Aufrufs von MappingRecognizeText enthält.

[in] data

Zeiger auf private Anwendungsdaten. Dieser Zeiger entspricht dem, der im pRecognizeCallerData-Member der MAPPING_OPTIONS-Struktur übergeben wurde.

[in] dwDataSize

Größe der privaten Anwendungsdaten in Byte. Diese Größe entspricht der Größe, die im dwRecognizeCallerDataSize-Member der MAPPING_OPTIONS-Struktur übergeben wird, wenn die Anwendung MappingRecognizeText asynchron aufruft.

[in] Result

Gibt Code aus MappingRecognizeText zurück. Der Rückgabecode wird S_OK, wenn die Funktion erfolgreich war, oder andernfalls ein Fehlercode.

Rückgabewert

Keine

Bemerkungen

Eine MappingCallbackProc-Funktion verwendet die von MappingRecognizeText abgerufenen Ergebnisse. Die Anwendung registriert die Rückruffunktion, indem sie ihre Adresse an MappingRecognizeText in einer MAPPING_OPTIONS-Struktur übergibt.

Die Anwendung sollte den Result-Parameter überprüfen, bevor die Daten im pBag-Parameter verwendet werden. Wenn die Daten aus dem Eigenschaftenbehälter verwendet werden, muss die Anwendung MappingFreePropertyBag aufrufen, da der Eigenschaftenbehälter Zeiger auf den ursprünglichen Text enthalten kann. Weitere Informationen zum Eigenschaftenbehälter finden Sie in den Hinweisen zur MAPPING_PROPERTY_BAG-Struktur .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	elscore.h