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

Obtém um objeto IPropertyStore que corresponde aos sinalizadores fornecidos.

Sintaxe

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

Parâmetros

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

Valores GETPROPERTYSTOREFLAGS que modificam o repositório retornado.

[in] pUnkFactory

Tipo: IUnknown*

Opcional. Um ponteiro para o IUnknown de um objeto que implementa ICreateObject. Se pUnkFactory for fornecido, esse método poderá criar a instância do manipulador usando ICreateObject em vez de CoCreateInstance, se implementado. O motivo para fornecer pUnkFactory geralmente é criar o manipulador em um processo diferente. No entanto, para a maioria dos usuários, passar NULL nesse parâmetro é suficiente.

[in] riid

Tipo: REFIID

Uma referência ao IID do objeto a ser criado.

[out] ppv

Tipo: void**

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

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

É recomendável que você use a macro IID_PPV_ARGS, definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Requisitos