IShellItem2::GetPropertyStoreWithCreateObject-Methode (shobjidl_core.h)

Artikel
03/02/2024

Verwendet das angegebene ICreateObject anstelle von CoCreateInstance, um eine instance des Eigenschaftenhandlers zu erstellen, der dem Shellelement zugeordnet ist, für das diese Methode aufgerufen wird. Die meisten aufrufenden Anwendungen müssen diese Methode nicht aufrufen und können stattdessen IShellItem2::GetPropertyStore aufrufen.

Syntax

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

Parameter

[in] flags

Typ: GETPROPERTYSTOREFLAGS

Die GETPROPERTYSTOREFLAGS-Konstanten , die das Eigenschaftenspeicherobjekt ändern.

[in] punkCreateObject

Typ: IUnknown*

Ein Zeiger auf eine Factory für die Erstellung mit niedrigen Rechten vom Typ ICreateObject.

Die CreateObject-Methode erstellt eine instance eines COM-Objekts. Die Implementierung von IShellItem2::GetPropertyStoreWithCreateObject verwendet CreateObject anstelle von CoCreateInstance , um den Eigenschaftenhandler, bei dem es sich um eine Shellerweiterung handelt, für einen bestimmten Dateityp zu erstellen. Der Eigenschaftenhandler stellt viele der wichtigen Eigenschaften im Eigenschaftenspeicher bereit, den diese Methode zurückgibt.

Diese Methode ist nur nützlich, wenn das ICreateObject-Objekt in einem separaten Prozess (als LOCALSERVER anstelle eines INPROCSERVER) erstellt wird und wenn dieser andere Prozess über niedrigere Rechte als der Prozess verfügt , der IShellItem2::GetPropertyStoreWithCreateObject aufruft.

[in] riid

Typ: REFIID

Ein Verweis auf die IID des abzurufenden Objekts.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält die Adresse des angeforderten IPropertyStore-Schnittstellenzeigers .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis Wenn diese Methode in einem Eigenschaftenspeicher für eine Datei aufgerufen wird, wird diese Datei für die Lebensdauer des IPropertyStore-Objekts geöffnet gehalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über