PFN_MAPPINGCALLBACKPROC fonction de rappel (elscore.h)

Article
02/27/2024

Fonction de rappel définie par l’application qui traite de manière asynchrone les données produites par la fonction MappingRecognizeText . Le type MAPPINGCALLBACKPROC définit un pointeur vers cette fonction de rappel. MappingCallbackProc est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

void PfnMappingcallbackproc(
  [in] _MAPPING_PROPERTY_BAG *pBag,
  [in] LPVOID data,
  [in] DWORD dwDataSize,
  [in] HRESULT Result
)
{...}

Paramètres

[in] pBag

Pointeur vers une structure MAPPING_PROPERTY_BAG contenant les résultats de l’appel à MappingRecognizeText.

[in] data

Pointeur vers des données d’application privées. Ce pointeur est le même que celui passé dans le membre pRecognizeCallerData de la structure MAPPING_OPTIONS .

[in] dwDataSize

Taille, en octets, des données d’application privée. Cette taille est identique à celle passée dans le membre dwRecognizeCallerDataSize de la structure MAPPING_OPTIONS lorsque l’application appelle MappingRecognizeText de manière asynchrone.

[in] Result

Retourne le code de MappingRecognizeText. Le code de retour est S_OK si la fonction a réussi, ou un code d’erreur dans le cas contraire.

Valeur de retour

None

Remarques

Une fonction MappingCallbackProc utilise les résultats récupérés par MappingRecognizeText. L’application inscrit la fonction de rappel en passant son adresse à MappingRecognizeText dans une structure MAPPING_OPTIONS .

L’application doit case activée le paramètre Result avant d’utiliser les données du paramètre pBag. Lorsque vous utilisez les données du conteneur de propriétés, l’application doit appeler MappingFreePropertyBag , car le conteneur de propriétés peut contenir des pointeurs vers le texte d’origine. Pour plus d’informations sur le conteneur de propriétés, consultez les remarques relatives à la structure MAPPING_PROPERTY_BAG .

Configuration requise

Condition requise	Valeur
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