Fonction GetBestResultString (recapis.h)

Récupère la meilleure chaîne de résultat.

Syntaxe

HRESULT GetBestResultString(
  HRECOCONTEXT hrc,
  ULONG        *pcSize,
  WCHAR        *pwcBestResult
);

Paramètres

hrc

Gérez le contexte du module de reconnaissance.

pcSize

Lors de l’entrée, le nombre de caractères que la mémoire tampon pwcBestResult peut contenir. À la sortie, le nombre de caractères que contient la mémoire tampon pwcBestResult . Si pwcBestResult a la valeur NULL, la fonction retourne la taille requise de la mémoire tampon que vous utilisez pour allouer la mémoire tampon pwcBestResult .

pwcBestResult

Résultat de la reconnaissance. Si la mémoire tampon est trop petite, la fonction tronque la chaîne. La chaîne n’est pas terminée par NULL. Pour déterminer la taille requise de la mémoire tampon, définissez pwcBestResult sur NULL ; utilisez pcSize pour allouer la mémoire tampon pwcBestResult .

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite. Pour les pays de reconnaissance latins et d’Asie de l’Est, ce résultat en combinaison avec une chaîne vide dans pwcBestResult signifie qu’il n’existe aucun résultat de reconnaissance.
TPC_S_TRUNCATED	La chaîne est tronquée pour tenir dans la mémoire tampon pwcBestResult .
E_POINTER	L’un des paramètres est un pointeur non valide.
E_FAIL	Une erreur non spécifiée s'est produite.
E_INVALIDARG	Un argument non valide a été reçu.
E_UNEXPECTED	Type de paramètre ou de propriété inattendu.
TPC_E_NOT_RELEVANT	Le contexte du module de reconnaissance ne contient pas de résultats.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	recapis.h
DLL	inkobjcore.dll