Função PSCreatePropertyStoreFromObject (propsys.h)

Aceita a interface IUnknown de um objeto que dá suporte a IPropertyStore ou IPropertySetStorage. Se o objeto der suporte a IPropertySetStorage, ele será encapsulado para que ele dê suporte a IPropertyStore.

Sintaxe

PSSTDAPI PSCreatePropertyStoreFromObject(
  [in]  IUnknown *punk,
  [in]  DWORD    grfMode,
  [in]  REFIID   riid,
  [out] void     **ppv
);

Parâmetros

[in] punk

Tipo: IUnknown*

Um ponteiro para uma interface que dá suporte a IPropertyStore ou IPropertySetStorage.

[in] grfMode

Tipo: DWORD

Especifica o modo de acesso a ser usado. Um destes valores:

STGM_READ

Abrir para leitura.

STGM_READWRITE

Aberto para leitura e gravação.

[in] riid

Tipo: REFIID

Referência ao IID solicitado.

[out] ppv

Tipo: void**

Quando essa função retorna com êxito, contém o endereço de um ponteiro para uma interface garantida para dar suporte a IPropertyStore.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se o objeto apontado pelo punk já dá suporte a IPropertyStore, nenhum wrapper é criado e o punk é retornado sem alterações.

Requisitos

Confira também

PSCreatePropertyStoreFromPropertySetStorage