IPersistPropertyBagImpl Class

Essa classe implementa IUnknown e permite que um objeto salve suas propriedades em um recipiente de propriedades fornecido pelo cliente.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

template <class T>
class ATL_NO_VTABLE IPersistPropertyBagImpl : public IPersistPropertyBag

Parâmetros

T
Sua classe, derivada de IPersistPropertyBagImpl.

Membros

Métodos públicos

Nome Descrição
IPersistPropertyBagImpl::GetClassID Recupera o CLSID do objeto.
IPersistPropertyBagImpl::InitNew Inicializa um objeto recém-criado. A implementação da ATL retorna S_OK.
IPersistPropertyBagImpl::Load Carrega as propriedades do objeto de um recipiente de propriedades fornecido pelo cliente.
IPersistPropertyBagImpl::Save Salva as propriedades do objeto em um recipiente de propriedades fornecido pelo cliente.

Comentários

A interface IPersistPropertyBag permite que um objeto salve suas propriedades em um recipiente de propriedades fornecido pelo cliente. A classe IPersistPropertyBagImpl fornece uma implementação padrão dessas interfaces e implementa IUnknown enviando informações para o dispositivo de despejo em builds de depuração.

IPersistPropertyBag funciona em conjunto com IPropertyBag e IErrorLog. Essas duas últimas interfaces devem ser implementadas pelo cliente. Por meio do IPropertyBag, o cliente salva e carrega as propriedades individuais do objeto. Por meio do IErrorLog, o objeto e o cliente podem relatar os erros encontrados.

Artigos relacionados Tutorial da ATL, criando um projeto da ATL

Hierarquia de herança

IPersistPropertyBag

IPersistPropertyBagImpl

Requisitos

Cabeçalho: atlcom.h

IPersistPropertyBagImpl::GetClassID

Recupera o CLSID do objeto.

STDMETHOD(GetClassID)(CLSID* pClassID);

Comentários

Confira IPersist::GetClassID no SDK do Windows.

IPersistPropertyBagImpl::InitNew

Inicializa um objeto recém-criado.

STDMETHOD(InitNew)();

Valor de retorno

Returns S_OK.

Comentários

Consulte IPersistPropertyBag::InitNew no SDK do Windows.

IPersistPropertyBagImpl::Load

Carrega as propriedades do objeto de um recipiente de propriedades fornecido pelo cliente.

STDMETHOD(Load)(LPPROPERTYBAG pPropBag, LPERRORLOG pErrorLog);

Comentários

A ATL usa o mapa de propriedades do objeto para recuperar essas informações.

Consulte IPersistPropertyBag::Load no SDK do Windows.

IPersistPropertyBagImpl::Save

Salva as propriedades do objeto em um recipiente de propriedades fornecido pelo cliente.

STDMETHOD(Save)(
    LPPROPERTYBAG pPropBag,
    BOOL fClearDirty,
    BOOL fSaveAllProperties);

Comentários

A ATL usa o mapa de propriedades do objeto para armazenar essas informações. Por padrão, esse método salva todas as propriedades, independentemente do valor de fSaveAllProperties.

Consulte IPersistPropertyBag::Save no SDK do Windows.

Confira também

BEGIN_PROP_MAP
Visão geral da aula