PFN_MAPPINGCALLBACKPROC Rückruffunktion (elscore.h)
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 |
Weitere Informationen
Erweiterte linguistische Dienste