Partager via


GetBestResultString, fonction (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érer 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. En 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 Descriptif
S_OK
Opération réussie.

Pour les reconnaissances latines et orientales, cela entraîne une combinaison d’une chaîne vide dans pwcBestResult , ce qui signifie qu’aucun résultat de reconnaissance n’existe.

TPC_S_TRUNCATED
La chaîne est tronquée pour s’adapter à 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
Paramètre ou type de propriété inattendu.
TPC_E_NOT_RELEVANT
Le contexte du module de reconnaissance ne contient pas de résultats.

Spécifications

Requirement Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau | Applications UWP]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Fenêtres
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll