Partilhar via


IPersistStorageImpl Classe

Esta classe implementa a interface IPersistStorage .

Importante

Essa classe e seus membros não podem ser usados em aplicativos executados no Tempo de Execução do Windows.

Sintaxe

template <class T>
class ATL_NO_VTABLE IPersistStorageImpl : public IPersistStorage

Parâmetros

T
Sua classe, derivada de IPersistStorageImpl.

Membros

Métodos Públicos

Nome Descrição
IPersistStorageImpl::GetClassID Recupera o CLSID do objeto.
IPersistStorageImpl::HandsOffStorage Instrui o objeto a liberar todos os objetos de armazenamento e entrar no modo HandsOff. A implementação ATL retorna S_OK.
IPersistStorageImpl::InitNew Inicializa um novo armazenamento.
IPersistStorageImpl::IsDirty Verifica se os dados do objeto foram alterados desde a última vez que foram salvos.
IPersistStorageImpl::Carregar Carrega as propriedades do objeto do armazenamento especificado.
IPersistStorageImpl::Salvar Salva as propriedades do objeto no armazenamento especificado.
IPersistStorageImpl::SaveCompleted Notifica um objeto de que ele pode retornar ao modo Normal para gravar em seu objeto de armazenamento. A implementação ATL retorna S_OK.

Observações

IPersistStorageImpl implementa a interface IPersistStorage , que permite que um cliente solicite que seu objeto carregue e salve seus dados persistentes usando um armazenamento.

A implementação desta classe requer T classe para tornar uma implementação da IPersistStreamInit interface disponível via QueryInterface. Normalmente, isso significa que a classe T deve derivar de IPersistStreamInitImpl, fornecer uma entrada para IPersistStreamInit no mapa COM e usar um mapa de propriedades para descrever os dados persistentes da classe.

Artigos RelacionadosATL Tutorial, Criando um projeto ATL

Hierarquia de herança

IPersistStorage

IPersistStorageImpl

Requerimentos

Cabeçalho: atlcom.h

IPersistStorageImpl::GetClassID

Recupera o CLSID do objeto.

STDMETHOD(GetClassID)(CLSID* pClassID);

Observações

Consulte IPersist::GetClassID no SDK do Windows.

IPersistStorageImpl::HandsOffStorage

Instrui o objeto a liberar todos os objetos de armazenamento e entrar no modo HandsOff.

STDMETHOD(HandsOffStorage)(void);

Valor de retorno

Devolve S_OK.

Observações

Consulte IPersistStorage::HandsOffStorage no SDK do Windows.

IPersistStorageImpl::InitNew

Inicializa um novo armazenamento.

STDMETHOD(InitNew)(IStorage*);

Observações

A implementação ATL delega à interface IPersistStreamInit .

Consulte IPersistStorage::InitNew no SDK do Windows.

IPersistStorageImpl::IsDirty

Verifica se os dados do objeto foram alterados desde a última vez que foram salvos.

STDMETHOD(IsDirty)(void);

Observações

A implementação ATL delega à interface IPersistStreamInit .

Consulte IPersistStorage::IsDirty no SDK do Windows.

IPersistStorageImpl::Carregar

Carrega as propriedades do objeto do armazenamento especificado.

STDMETHOD(Load)(IStorage* pStorage);

Observações

A implementação ATL delega à interface IPersistStreamInit . Load usa um fluxo chamado "Conteúdo" para recuperar os dados do objeto. O método Save originalmente cria esse fluxo.

Consulte IPersistStorage::Load no SDK do Windows.

IPersistStorageImpl::Salvar

Salva as propriedades do objeto no armazenamento especificado.

STDMETHOD(Save)(IStorage* pStorage, BOOL fSameAsLoad);

Observações

A implementação ATL delega à interface IPersistStreamInit . Quando Save é chamado pela primeira vez, ele cria um fluxo chamado "Conteúdo" no armazenamento especificado. Esse fluxo é usado em chamadas posteriores para Save e em chamadas para Load.

Consulte IPersistStorage::Save no SDK do Windows.

IPersistStorageImpl::SaveCompleted

Notifica um objeto de que ele pode retornar ao modo Normal para gravar em seu objeto de armazenamento.

STDMETHOD(SaveCompleted)(IStorage*);

Valor de retorno

Devolve S_OK.

Observações

Consulte IPersistStorage::SaveCompleted no SDK do Windows.

Ver também

Armazenamentos e fluxos
IPersistStreamInitImpl Classe
IPersistPropertyBagImpl Classe
Visão geral da classe