Partager via


SetFactoid, fonction (recapis.h)

Spécifie le factoid utilisé par un module de reconnaissance pour limiter sa recherche du résultat.

Vous spécifiez un factoid si un champ d’entrée est d’un type connu, par exemple si le champ d’entrée contient une date. Vous appelez cette fonction avant de traiter l’entrée manuscrite pour la première fois. Par conséquent, appelez la fonction SetFactoid avant d’appeler la fonction Process .

Syntaxe

HRESULT SetFactoid(
  HRECOCONTEXT hrc,
  ULONG        cwcFactoid,
  const WCHAR  *pwcFactoid
);

Paramètres

hrc

Gérez le contexte du module de reconnaissance.

cwcFactoid

Nombre de caractères dans pwcFactoid.

pwcFactoid

Identifie le factoid à utiliser sur le contexte du module de reconnaissance. La chaîne n’est pas terminée par NULL.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
TPC_E_INVALID_PROPERTY
Le factoid spécifié n’est pas pris en charge.
TPC_E_OUT_OF_ORDER_CALL
Vous devez appeler la fonction SetFactoid avant d’appeler la fonction Process.
E_POINTER
Le contexte n’est pas valide ou l’un des paramètres est un pointeur non valide.
E_NOTIMPL
Le module de reconnaissance ne prend pas en charge cette fonction.
E_OUTOFMEMORY
Impossible d’allouer de la mémoire pour terminer l’opération.
E_FAIL
Une erreur non spécifiée s'est produite.
E_INVALIDARG
Le contexte contient une valeur non valide.

Remarques

Pour obtenir la liste des factoids qui peuvent être passés dans le paramètre cwcFactoid , consultez Factoids pris en charge à partir de la version 1. Le factoid DEFAULT répertorié dans cette rubrique n’est pas une valeur valide à passer à SetFactoid ; L’API de plateforme Tablet PC convertit en interne DEFAULT en NULL avant d’appeler la fonction SetFactoid .

Il est recommandé de limiter la longueur de la chaîne factoid à 32 768 caractères maximum.

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

Voir aussi

SetFlags, fonction