Méthode IPropertyStore ::GetValue (propsys.h)
Cette méthode récupère les données d’une propriété spécifique.
Syntaxe
HRESULT GetValue(
REFPROPERTYKEY key,
PROPVARIANT *pv
);
Paramètres
key
TBD
pv
Une fois la IPropertyStore::GetValue méthode retournée, ce paramètre pointe vers une structure PROPVARIANT qui contient des données sur la propriété.
Valeur retournée
Retourne S_OK ou INPLACE_S_TRUNCATED en cas de réussite, ou une valeur d’erreur dans le cas contraire.
INPLACE_S_TRUNCATED est retourné pour indiquer que le PROPVARIANT retourné a été converti dans une forme plus canonique. Par exemple, cela permet de réduire les espaces de début ou de fin d’une valeur de chaîne. Vous devez utiliser la macro SUCCEEDED pour case activée la valeur de retour, qui traite INPLACE_S_TRUNCATED comme un code de réussite. La macro SUCCEEDED est définie dans le fichier Winerror.h.
Remarques
Si la PROPRIÉTÉKEY référencée dans la clé n’est pas présente dans le magasin de propriétés, cette méthode retourne S_OK et le membre vt de la structure vers lequel pv pointe est défini sur VT_EMPTY.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible avec Windows Vista et les versions ultérieures du système d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | propsys.h |
| Bibliothèque | Propsys.idl |
| IRQL | Tous les niveaux |