Compartir a través de

Método IShellItem2::GetPropertyStoreWithCreateObject (shobjidl_core.h)

  • Artículo

Usa el ICreateObject especificado en lugar de CoCreateInstance para crear una instancia del controlador de propiedades asociado al elemento shell en el que se llama a este método. La mayoría de las aplicaciones que llaman no necesitan llamar a este método y pueden llamar a IShellItem2::GetPropertyStore en su lugar.

Sintaxis

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

Parámetros

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

Constantes GETPROPERTYSTOREFLAGS que modifican el objeto de almacén de propiedades.

[in] punkCreateObject

Tipo: IUnknown*

Puntero a una fábrica para la creación de derechos bajos de tipo ICreateObject.

El método CreateObject crea una instancia de un objeto COM. La implementación de IShellItem2::GetPropertyStoreWithCreateObject usa CreateObject en lugar de CoCreateInstance para crear el controlador de propiedades, que es una extensión shell, para un tipo de archivo determinado. El controlador de propiedades proporciona muchas de las propiedades importantes del almacén de propiedades que devuelve este método.

Este método solo es útil si el objeto ICreateObject se crea en un proceso independiente (como LOCALSERVER en lugar de un INPROCSERVER) y también si este otro proceso tiene derechos inferiores a los del proceso que llama a IShellItem2::GetPropertyStoreWithCreateObject.

[in] riid

Tipo: REFIID

Referencia al IID del objeto que se va a recuperar.

[out] ppv

Tipo: void**

Cuando este método devuelve, contiene la dirección del puntero de interfaz IPropertyStore solicitado.

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

Nota Cuando se llama a este método en un almacén de propiedades para un archivo, ese archivo se mantiene abierto durante la vigencia del objeto IPropertyStore .
 

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 shobjidl_core.h (incluya Shobjidl.h)