Partager via


SetContextPropertyValue, fonction (recapis.h)

Ajoute une propriété au contexte du module de reconnaissance.

Si une propriété existe déjà, sa valeur est modifiée.

Syntaxe

HRESULT SetContextPropertyValue(
  HRECOCONTEXT hrc,
  GUID         *pGuid,
  ULONG        cbSize,
  BYTE         *pProperty
);

Paramètres

hrc

Handle du contexte du module de reconnaissance.

pGuid

Propriété à obtenir. Spécifiez un identificateur global unique (GUID) de propriété prédéfinie ou un GUID de propriété défini par l’application. Pour obtenir la liste des propriétés prédéfinies, consultez les GUID de propriété de reconnaissance.

cbSize

Taille, en octets, de la mémoire tampon pProperty .

pProperty

Mémoire tampon qui contient la valeur de propriété.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_FAIL
Une erreur non spécifiée s'est produite.
E_POINTER
pGUID n’est pas valide ou cbSize a été défini sur une très grande valeur non valide.
TPC_E_INVALID_PROPERTY
pGUID n’est pas valide.
E_INVALIDARG
cbSize n’est pas valide.
S_FALSE
Retourné lorsqu’une tentative de définition d’une valeur de propriété est effectuée alors qu’elle a déjà été activée.

Remarques

La fonction SetContextPropertyValue est facultative.

Configuration requise

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

Voir aussi

GetContextPropertyList, fonction

GetContextPropertyValue, fonction