Compartilhar via


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

Usa o ICreateObject especificado em vez de CoCreateInstance para criar uma instância do manipulador de propriedades associado ao item Shell no qual esse método é chamado. A maioria dos aplicativos de chamada não precisa chamar esse método e pode chamar IShellItem2::GetPropertyStore .

Sintaxe

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

Parâmetros

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

As constantes GETPROPERTYSTOREFLAGS que modificam o objeto do repositório de propriedades.

[in] punkCreateObject

Tipo: IUnknown*

Um ponteiro para uma fábrica para criação de direitos baixos do tipo ICreateObject.

O método CreateObject cria uma instância de um objeto COM. A implementação de IShellItem2::GetPropertyStoreWithCreateObject usa CreateObject em vez de CoCreateInstance para criar o manipulador de propriedades, que é uma extensão shell, para um determinado tipo de arquivo. O manipulador de propriedades fornece muitas das propriedades importantes no repositório de propriedades que esse método retorna.

Esse método só será útil se o objeto ICreateObject for criado em um processo separado (como UM LOCALSERVER em vez de UM INPROCSERVER) e também se esse outro processo tiver direitos inferiores ao processo que chama IShellItem2::GetPropertyStoreWithCreateObject.

[in] riid

Tipo: REFIID

Uma referência à IID do objeto a ser recuperado.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o endereço do ponteiro de interface IPropertyStore solicitado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Nota Quando esse método é chamado em um repositório de propriedades para um arquivo, esse arquivo é mantido aberto durante o tempo de vida do objeto IPropertyStore .
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)