Metodo IShellItem2::GetPropertyStoreWithCreateObject (shobjidl_core.h)

Articolo
03/05/2024

Usa l'oggetto ICreateObject specificato anziché CoCreateInstance per creare un'istanza del gestore di proprietà associato all'elemento Shell in cui viene chiamato questo metodo. La maggior parte delle applicazioni chiamante non deve chiamare questo metodo e può chiamare invece IShellItem2::GetPropertyStore .

Sintassi

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

Parametri

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

Costanti GETPROPERTYSTOREFLAGS che modificano l'oggetto archivio delle proprietà.

[in] punkCreateObject

Tipo: IUnknown*

Puntatore a una factory per la creazione di diritti limitati di tipo ICreateObject.

Il metodo CreateObject crea un'istanza di un oggetto COM. L'implementazione di IShellItem2::GetPropertyStoreWithCreateObject usa CreateObject anziché CoCreateInstance per creare il gestore di proprietà, ovvero un'estensione shell, per un determinato tipo di file. Il gestore delle proprietà fornisce molte delle proprietà importanti nell'archivio delle proprietà restituito da questo metodo.

Questo metodo è utile solo se l'oggetto ICreateObject viene creato in un processo separato (come LOCALSERVER anziché INPROCSERVER) e anche se questo altro processo ha diritti inferiori rispetto al processo che chiama IShellItem2::GetPropertyStoreWithCreateObject.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'oggetto da recuperare.

[out] ppv

Tipo: void**

Quando termina, questo metodo contiene l'indirizzo del puntatore all'interfaccia IPropertyStore richiesto.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Nota Quando questo metodo viene chiamato in un archivio di proprietà per un file, tale file viene mantenuto aperto per tutta la durata dell'oggetto IPropertyStore .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite