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

Article
03/01/2024

Obtient un objet IPropertyStore , en fonction d’un ensemble de clés de propriété. Cela fournit une méthode alternative, éventuellement plus rapide, pour obtenir un objet IPropertyStore par rapport à l’appel de IPropertyStoreFactory ::GetPropertyStore.

Syntaxe

HRESULT GetPropertyStoreForKeys(
  [in]  const PROPERTYKEY     *rgKeys,
  [in]  UINT                  cKeys,
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Paramètres

[in] rgKeys

Type : const PROPERTYKEY*

Pointeur vers un tableau de structures PROPERTYKEY .

[in] cKeys

Type : UINT

Nombre de structures PROPERTYKEY dans le tableau pointé par rgKeys.

[in] flags

Type : GETPROPERTYSTOREFLAGS

Valeurs GETPROPERTYSTOREFLAGS qui modifient le magasin retourné.

[in] riid

Type : REFIID

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

[out] ppv

Type : void**

Lorsque cette méthode est retournée, 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 par 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