Méthode ITfContext::GetAppProperty (msctf.h)

Obtient une propriété d’application.

Syntaxe

HRESULT GetAppProperty(
  [in]  REFGUID             guidProp,
  [out] ITfReadOnlyProperty **ppProp
);

Paramètres

[in] guidProp

Spécifie l’identificateur de propriété. Il peut s’agir d’un identificateur personnalisé ou d’un des identificateurs de propriété prédéfinis.

[out] ppProp

Pointeur vers un pointeur d’interface ITfReadOnlyProperty qui reçoit l’objet de propriété.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
S_FALSE	Le propriétaire de contexte ne prend pas en charge la propriété.
TF_E_DISCONNECTED	Le contexte ne se trouve pas sur une pile de documents.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
E_OUTOFMEMORY	Un échec d’allocation de mémoire s’est produit.
E_NOTIMPL	Le propriétaire du contexte n’implémente pas cette méthode.
E_FAIL	Une erreur non spécifiée s'est produite.

Notes

Les applications peuvent définir des propriétés uniques identifiées par un GUID. Les propriétés étant stockées sous forme de données VARIANT, l’appelant doit reconnaître le format et la signification des propriétés uniques pour pouvoir les utiliser.

Les propriétés d’application diffèrent des propriétés de texte, obtenues par ITfContext::GetProperty, en ce que les propriétés d’application sont conservées par le propriétaire du contexte et ne peuvent pas être modifiées par un service de texte. Les propriétés de l’application ne peuvent être modifiées que par le propriétaire du contexte.

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

Interface ITfContext, ITfContext::GetProperty, interface ITfReadOnlyProperty, Propriétés prédéfinies