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.

Warnung Die Daten, auf die durch die Argumente pszText und pOptions verwiesen werden, die an MappingRecognizeText übergeben 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

Weitere Informationen

Erweiterte Sprachdienste

Erweiterte Sprachdienstefunktionen

MAPPING_PROPERTY_BAG

MappingRecognizeText