Partager via

Fonction GetBestResultString (recapis.h)

  • Article

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