Metodo IPropertyStoreFactory::GetPropertyStore (propsys.h)

Articolo
08/25/2023

Ottiene un oggetto IPropertyStore che corrisponde ai flag specificati.

Sintassi

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

Parametri

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

Valori GETPROPERTYSTOREFLAGS che modificano l'archivio restituito.

[in] pUnkFactory

Tipo: IUnknown*

facoltativo. Puntatore all'oggetto IUnknown di un oggetto che implementa ICreateObject. Se viene specificato pUnkFactory , questo metodo può creare l'istanza del gestore usando ICreateObject anziché CoCreateInstance, se implementata. Il motivo per fornire pUnkFactory è in genere creare il gestore in un processo diverso. Tuttavia, per la maggior parte degli utenti, il passaggio di NULL in questo parametro è sufficiente.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'oggetto da creare.

[out] ppv

Tipo: void**

Quando termina, questo metodo contiene l'indirizzo di un puntatore all'interfaccia IPropertyStore .

Valore restituito

Tipo: HRESULT

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

Commenti

È consigliabile usare la macro IID_PPV_ARGS, definita in Objbase.h, per creare il pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica.

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	propsys.h

Condividi tramite