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

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