Metodo IPropertyStoreFactory::GetPropertyStoreForKeys (propsys.h)

Articolo
03/01/2024

Ottiene un oggetto IPropertyStore , dato un set di chiavi di proprietà. Ciò offre un metodo alternativo, possibilmente più rapido, per ottenere un oggetto IPropertyStore rispetto alla chiamata di IPropertyStoreFactory::GetPropertyStore.

Sintassi

HRESULT GetPropertyStoreForKeys(
  [in]  const PROPERTYKEY     *rgKeys,
  [in]  UINT                  cKeys,
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Parametri

[in] rgKeys

Tipo: const PROPERTYKEY*

Puntatore a una matrice di strutture PROPERTYKEY .

[in] cKeys

Tipo: UINT

Numero di strutture PROPERTYKEY nella matrice a cui punta rgKeys.

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

Valori GETPROPERTYSTOREFLAGS che modificano l'archivio restituito.

[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