Fonction MappingDoAction (elscore.h)

Provoque l’exécution d’une action par un service ELS après la reconnaissance de texte. Par exemple, un service de numéroteur téléphonique doit d’abord reconnaître les numéros de téléphone, puis peut effectuer l'« action » de composer un numéro.

Syntaxe

HRESULT MappingDoAction(
  [in, out] PMAPPING_PROPERTY_BAG pBag,
  [in]      DWORD                 dwRangeIndex,
  [in]      LPCWSTR               pszActionId
);

Paramètres

[in, out] pBag

Pointeur vers une structure MAPPING_PROPERTY_BAG contenant les résultats d’un appel précédent à MappingRecognizeText. Ce paramètre ne peut pas être défini sur NULL.

[in] dwRangeIndex

Index de départ à l’intérieur des résultats de la reconnaissance de texte pour une plage de texte reconnue. Cette valeur doit être comprise entre 0 et le nombre de plages.

[in] pszActionId

Pointeur vers l’identificateur de l’action à effectuer. Ce paramètre ne peut pas être défini sur NULL.

Valeur retournée

Retourne S_OK en cas de réussite. La fonction retourne une valeur HRESULT d’erreur si elle ne réussit pas.

Notes

L’application doit précéder l’appel à MappingDoAction d’un appel à MappingRecognizeText.

Avertissement Données référencées par les arguments pszText et pOptions passés à MappingRecognizeText

doit rester valide jusqu’à ce que la structure du conteneur de propriétés passée par pBag soit libérée via

MappingFreePropertyBag. Cela est dû au fait que les appels synchrones et asynchrones à

MappingRecognizeText et MappingDoAction tenteront d’utiliser les données passées à l’initial

appelez à MappingRecognizeText.

 

Spécifications

Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	elscore.h
Bibliothèque	Elscore.lib
DLL	Elscore.dll

Voir aussi

Services linguistiques étendus

Fonctions des services linguistiques étendus

MAPPING_PROPERTY_BAG

MappingRecognizeText