Partager via


PSPropertyBag_ReadUnknown, fonction (propsys.h)

Lit une propriété donnée d’une valeur de données inconnue dans un conteneur de propriétés.

Syntaxe

PSSTDAPI PSPropertyBag_ReadUnknown(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [in]  REFIID       riid,
  [out] void         **ppv
);

Paramètres

[in] propBag

Type : IPropertyBag*

Pointeur vers un objet IPropertyBag , qui représente le conteneur de propriétés dans lequel la propriété est stockée.

[in] propName

Type : LPCWSTR

Pointeur vers une chaîne de nom de propriété terminée par null.

[in] riid

Type : REFIID

Référence à l’IID de l’interface à récupérer via ppv. Cette interface IID doit être IPropertyBag ou une interface dérivée de IPropertyBag.

[out] ppv

Type : void**

Lorsque cette méthode retourne correctement, contient le pointeur d’interface demandé dans riid. Il s’agit généralement de riid.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

IPropertyBag et IPersistPropertyBag optimisent la fonctionnalité Enregistrer en tant que texte. IPropertyBag et IPropertyBag2 fournissent un objet avec un conteneur de propriétés dans lequel l’objet peut enregistrer ses propriétés de manière permanente. IPropertyBag2 permet à l’objet d’obtenir des informations de type pour chaque propriété : IPropertyBag2 ::Read entraîne la lecture d’une ou plusieurs propriétés à partir du conteneur de propriétés, et IPropertyBag2 ::Write entraîne l’enregistrement d’une ou plusieurs propriétés dans le conteneur de propriétés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête propsys.h
Bibliothèque Propsys.lib
DLL Propsys.dll (version 6.0 ou ultérieure)

Voir aussi

PSPropertyBag_WriteUnknown