Método IPropertyStoreFactory::GetPropertyStoreForKeys (propsys.h)

Obtiene un objeto IPropertyStore , dado un conjunto de claves de propiedad. Esto proporciona un método alternativo, posiblemente más rápido, de obtener un objeto IPropertyStore en comparación con la llamada a IPropertyStoreFactory::GetPropertyStore.

Sintaxis

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

Parámetros

[in] rgKeys

Tipo: const PROPERTYKEY*

Puntero a una matriz de estructuras PROPERTYKEY .

[in] cKeys

Tipo: UINT

Número de estructuras PROPERTYKEY de la matriz a la que apunta rgKeys.

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

Valores GETPROPERTYSTOREFLAGS que modifican el almacén que se devuelve.

[in] riid

Tipo: REFIID

Referencia a IID del objeto que se va a crear.

[out] ppv

Tipo: void**

Cuando este método vuelve, contiene la dirección de un puntero de interfaz IPropertyStore .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se recomienda usar la macro IID_PPV_ARGS, definida en Objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor en ppv, lo que elimina la posibilidad de un error de codificación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h