Fonction MappingRecognizeText (elscore.h)

Article
08/23/2023

Appelle un service ELS pour reconnaître le texte. Par exemple, le service De détection de langue Microsoft tente de reconnaître la langue dans laquelle le texte d’entrée est écrit.

Syntaxe

HRESULT MappingRecognizeText(
  [in]           PMAPPING_SERVICE_INFO pServiceInfo,
  [in]           LPCWSTR               pszText,
  [in]           DWORD                 dwLength,
  [in]           DWORD                 dwIndex,
  [in, optional] PMAPPING_OPTIONS      pOptions,
  [in, out]      PMAPPING_PROPERTY_BAG pbag
);

Paramètres

[in] pServiceInfo

Pointeur vers une structure MAPPING_SERVICE_INFO contenant des informations sur le service à utiliser dans la reconnaissance de texte. La structure doit être l’une des structures récupérées par un appel précédent à MappingGetServices. Ce paramètre ne peut pas être défini sur NULL.

[in] pszText

Pointeur vers le texte à reconnaître. Le texte doit être UTF-16, mais certains services ont des exigences supplémentaires pour le format d’entrée. Ce paramètre ne peut pas être défini sur NULL.

[in] dwLength

Longueur, en caractères, du texte spécifié dans pszText.

[in] dwIndex

Indexer à l’intérieur du texte spécifié à utiliser par le service. Cette valeur doit être comprise entre 0 et dwLength-1. Si l’application souhaite traiter l’intégralité du texte, elle doit définir ce paramètre sur 0.

[in, optional] pOptions

Pointeur vers une structure MAPPING_OPTIONS contenant des options qui affectent le résultat et le comportement de la reconnaissance de texte. L’application n’a pas besoin de spécifier des valeurs pour tous les membres de la structure. Ce paramètre peut être défini sur NULL pour utiliser les options de mappage par défaut.

[in, out] pbag

Pointeur vers une structure MAPPING_PROPERTY_BAG dans laquelle le service stocke ses résultats. Lors de l’entrée, l’application transmet une structure avec uniquement la taille fournie et les autres membres définis sur 0. À la sortie, la structure est remplie d’informations produites par le service lors de la reconnaissance de texte. 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 échoue.

Notes

Le type de texte à reconnaître dépend du type de service utilisé par l’application. Pour plus d’informations, consultez Demande de reconnaissance de texte.

Avertissement Les données référencées par pszText et pOptions doivent rester valides jusqu’à ce que la structure du conteneur de propriétés transmise 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 transmises à l’initial

appel à MappingRecognizeText.

Spécifications


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