Compartir a través de

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

  • Artículo

Obtiene un objeto IPropertyStore que corresponde a las marcas proporcionadas.

Sintaxis

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

Parámetros

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

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

[in] pUnkFactory

Tipo: IUnknown*

Opcional. Puntero al IUnknown de un objeto que implementa ICreateObject. Si se proporciona pUnkFactory , este método puede crear la instancia del controlador mediante ICreateObject en lugar de CoCreateInstance, si se implementa. La razón para proporcionar pUnkFactory suele ser crear el controlador en un proceso diferente. Sin embargo, para la mayoría de los usuarios, pasar NULL en este parámetro es suficiente.

[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