Metodo IShellItem2::GetPropertyStoreWithCreateObject (shobjidl_core.h)

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

Requisiti