MappingDoAction-Funktion (elscore.h)
Bewirkt, dass ein ELS-Dienst nach der Texterkennung eine Aktion ausführt. Beispielsweise muss ein Telefonwähldienst zunächst Telefonnummern erkennen und kann dann die "Aktion" des Wählens einer Nummer ausführen.
Syntax
HRESULT MappingDoAction(
[in, out] PMAPPING_PROPERTY_BAG pBag,
[in] DWORD dwRangeIndex,
[in] LPCWSTR pszActionId
);
Parameter
[in, out] pBag
Zeiger auf eine MAPPING_PROPERTY_BAG-Struktur , die die Ergebnisse eines vorherigen Aufrufs von MappingRecognizeText enthält. Dieser Parameter kann nicht auf NULL festgelegt werden.
[in] dwRangeIndex
Ein Startindex innerhalb der Texterkennung ergibt für einen erkannten Textbereich. Dieser Wert sollte zwischen 0 und der Bereichsanzahl liegen.
[in] pszActionId
Zeiger auf den Bezeichner der auszuführenden Aktion. Dieser Parameter kann nicht auf NULL festgelegt werden.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück. Die Funktion gibt einen HRESULT-Fehlerwert zurück, wenn sie nicht erfolgreich ist.
Hinweise
Der Anwendung muss dem Aufruf von MappingDoAction ein Aufruf von MappingRecognizeText vorangestellt werden.
muss gültig bleiben, bis die von pBag übergebene Eigenschaftsbeutelstruktur über freigegeben wird
MappingFreePropertyBag. Dies liegt daran, dass sowohl synchrone als auch asynchrone Aufrufe von
MappingRecognizeText und MappingDoAction versuchen, die an den Ersten übergebenen Daten zu verwenden.
Rufen Sie MappingRecognizeText auf.
Anforderungen
| 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 |
| Bibliothek | Elscore.lib |
| DLL | Elscore.dll |