structure MAPPING_OPTIONS (elscore.h)

Contient des options pour la reconnaissance de texte. Les valeurs stockées dans cette structure affectent le comportement et les résultats de MappingRecognizeText.

Syntaxe

typedef struct _MAPPING_OPTIONS {
  size_t                  Size;
  LPWSTR                  pszInputLanguage;
  LPWSTR                  pszOutputLanguage;
  LPWSTR                  pszInputScript;
  LPWSTR                  pszOutputScript;
  LPWSTR                  pszInputContentType;
  LPWSTR                  pszOutputContentType;
  LPWSTR                  pszUILanguage;
  PFN_MAPPINGCALLBACKPROC pfnRecognizeCallback;
  LPVOID                  pRecognizeCallerData;
  DWORD                   dwRecognizeCallerDataSize;
  PFN_MAPPINGCALLBACKPROC pfnActionCallback;
  LPVOID                  pActionCallerData;
  DWORD                   dwActionCallerDataSize;
  DWORD                   dwServiceFlag;
  unsigned                GetActionDisplayName : 1;
} MAPPING_OPTIONS, *PMAPPING_OPTIONS;

Membres

Size

Taille de la structure, utilisée pour valider la version de la structure. Cette valeur est requise.

pszInputLanguage

Optionnel. Pointeur vers une chaîne de langue d’entrée, suivant la convention de nommage IETF, qui identifie la langue d’entrée que le service doit être en mesure d’accepter. L’application peut définir ce membre sur NULL pour indiquer que le service est libre d’interpréter l’entrée comme n’importe quel langage d’entrée qu’il prend en charge.

pszOutputLanguage

Optionnel. Pointeur vers une chaîne de langue de sortie, suivant la convention de nommage IETF, qui identifie la langue de sortie que le service doit être en mesure d’utiliser pour produire des résultats. L’application peut définir ce membre sur NULL si le service doit décider de la langue de sortie.

pszInputScript

Optionnel. Pointeur vers un nom de script Unicode standard qui doit être accepté par le service. L’application peut définir ce membre sur NULL pour permettre au service de décider de la façon dont l’entrée est gérée.

pszOutputScript

Optionnel. Pointeur vers un nom de script Unicode standard que le service doit utiliser pour récupérer les résultats. L’application peut définir ce membre sur NULL pour permettre au service de décider du script de sortie.

pszInputContentType

Optionnel. Pointeur vers une chaîne, suivant le format des types de contenu MIME, qui identifie le format que le service doit être en mesure d’interpréter lorsque l’application transmet des données. Les types de contenu « text/plain », « text/html » et « text/css » sont des exemples de types de contenu. L’application peut définir ce membre sur NULL pour indiquer le type de contenu « text/plain ».

Note Dans Windows 7, les services ELS prennent uniquement en charge le type de contenu « text/plain ». Vous trouverez une spécification de type de contenu dans Types de média texte.

 

pszOutputContentType

Optionnel. Pointeur vers une chaîne, suivant le format des types de contenu MIME, qui identifie le format dans lequel le service doit récupérer des données. L’application peut définir ce membre sur NULL pour permettre au service de décider du type de contenu de sortie.

pszUILanguage

Réservé.

pfnRecognizeCallback

Optionnel. Pointeur vers une fonction de rappel d’application pour recevoir des rappels avec les résultats de la fonction MappingRecognizeText . Si une fonction de rappel est spécifiée, la reconnaissance de texte est exécutée en mode asynchrone et l’application obtient des résultats via la fonction de rappel. L’application doit définir ce membre sur NULL si la reconnaissance de texte doit être synchrone.

pRecognizeCallerData

Optionnel. Pointeur vers les données d’application privées transmises à la fonction de rappel par un service une fois la reconnaissance de texte terminée. L’application doit définir ce membre sur NULL pour indiquer aucune donnée d’application privée.

dwRecognizeCallerDataSize

Optionnel. Taille, en octets, de toutes les données d’application privée indiquées par le membre pRecognizeCallerData .

pfnActionCallback

Réservé.

pActionCallerData

Réservé.

dwActionCallerDataSize

Réservé.

dwServiceFlag

Optionnel. Indicateur privé défini par un fournisseur de services pour affecter le comportement du service. Les services peuvent interpréter cet indicateur selon leurs besoins.

Note Pour Windows 7, aucun des services ELS disponibles ne prend en charge les indicateurs.

 

GetActionDisplayName

Réservé.

Notes

L’application n’a pas besoin de renseigner tous les membres de cette structure, car les services traitent les membres NULL comme des valeurs par défaut. Tous les membres inutilisés doivent être définis sur 0.

Avertissement Les données transmises dans cette structure à MappingRecognizeText, ainsi que les données référencées par l’argument pszText dans cet appel,

doit rester valide jusqu’à ce que la structure de sac 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 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]
En-tête	elscore.h

Voir aussi

Structures étendues des services linguistiques

MAPPING_DATA_RANGE

MappingRecognizeText