IsStringSupported, fonction (recapis.h)

Article
03/06/2024

Retourne une valeur qui indique si un mot, une date, une heure, un nombre ou un autre texte transmis est contenu dans le dictionnaire.

Les résultats de ce test dépendent du paramètre factoid.

Syntaxe

HRESULT IsStringSupported(
  HRECOCONTEXT hrc,
  ULONG        wcString,
  const WCHAR  *pwcString
);

Paramètres

hrc

Handle du contexte du module de reconnaissance.

wcString

Nombre, en caractères Unicode (larges), de pwcString.

pwcString

Caractères Unicode (larges) à tester.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite. Cette fonction retourne également S_OK si 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.
S_FALSE	La chaîne n’est pas prise en charge.
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.

Remarques

Cette fonction est facultative.

Les résultats de ce test dépendent du paramètre factoid. Par exemple, si le paramètre factoid est défini sur la valeur par défaut, alors « hello », « 555-1234 » et « 19/10/2002 » retournent tous S_OK. Toutefois, si le factoid est défini sur TELEPHONE, seul « 555-1234 » retourne S_OK, les autres renvoient S_FALSE. Pour plus d’informations sur les factoids, consultez Factoids pris en charge à partir de la version 1.

Notez que cette fonction doit prendre en compte toutes les informations spécifiées dans SetTextContext lors du retour d’une valeur. Par exemple, si le module de reconnaissance reçoit des appels à SetTextContext (« http : », « ») et reçoit un factoid d’URL, SetFactoid (( !IS_URL)), IsStringSupported(« www.microsoft.com ») doit retourner S_FALSE car il manque le « // ».

L’indicateur COERCE n’a aucun effet sur IsStringSupported.

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

Partager via