Méthode IPropertyStoreFactory ::GetPropertyStore (propsys.h)

Article
03/04/2024

Obtient un objet IPropertyStore qui correspond aux indicateurs fournis.

Syntaxe

HRESULT GetPropertyStore(
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  IUnknown              *pUnkFactory,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Paramètres

[in] flags

Type : GETPROPERTYSTOREFLAGS

VALEURS GETPROPERTYSTOREFLAGS qui modifient le magasin retourné.

[in] pUnkFactory

Type : IUnknown*

facultatif. Pointeur vers l’IUnknown d’un objet qui implémente ICreateObject. Si pUnkFactory est fourni, cette méthode peut créer le gestionnaire instance à l’aide d’ICreateObject plutôt que de CoCreateInstance, si elle est implémentée. La raison de fournir pUnkFactory est généralement de créer le gestionnaire dans un autre processus. Toutefois, pour la plupart des utilisateurs, la transmission de la valeur NULL dans ce paramètre est suffisante.

[in] riid

Type : REFIID

Référence à l’IID de l’objet à créer.

[out] ppv

Type : void**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur d’interface IPropertyStore .

Valeur retournée

Type : HRESULT

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

Remarques

Il est recommandé d’utiliser la macro IID_PPV_ARGS, définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée vers la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h

Partager via