Méthode IShellItem2 ::GetPropertyStoreWithCreateObject (shobjidl_core.h)

Article
03/04/2024

Utilise le ICreateObject spécifié au lieu de CoCreateInstance pour créer un instance du gestionnaire de propriétés associé à l’élément Shell sur lequel cette méthode est appelée. La plupart des applications appelantes n’ont pas besoin d’appeler cette méthode et peuvent appeler IShellItem2 ::GetPropertyStore à la place.

Syntaxe

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

Paramètres

[in] flags

Type : GETPROPERTYSTOREFLAGS

Constantes GETPROPERTYSTOREFLAGS qui modifient l’objet de magasin de propriétés.

[in] punkCreateObject

Type : IUnknown*

Pointeur vers une fabrique pour la création de droits faibles de type ICreateObject.

La méthode CreateObject crée un instance d’un objet COM. L’implémentation de IShellItem2 ::GetPropertyStoreWithCreateObject utilise CreateObject au lieu de CoCreateInstance pour créer le gestionnaire de propriétés, qui est une extension Shell, pour un type de fichier donné. Le gestionnaire de propriétés fournit la plupart des propriétés importantes dans le magasin de propriétés que cette méthode retourne.

Cette méthode n’est utile que si l’objet ICreateObject est créé dans un processus distinct (en tant que LOCALSERVER au lieu d’un INPROCSERVER), et également si cet autre processus a des droits inférieurs à ceux du processus appelant IShellItem2 ::GetPropertyStoreWithCreateObject.

[in] riid

Type : REFIID

Référence à l’IID de l’objet à récupérer.

[out] ppv

Type : void**

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

Valeur retournée

Type : HRESULT

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

Remarques

Note Lorsque cette méthode est appelée sur un magasin de propriétés pour un fichier, ce fichier est conservé ouvert pendant toute la durée de vie de l’objet IPropertyStore .

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	shobjidl_core.h (inclure Shobjidl.h)

Partager via