Interface IPersistStream (objidl.h)

  • Artigo

Habilita o salvamento e o carregamento de objetos que usam um fluxo serial simples para suas necessidades de armazenamento.

Herança

A interface IPersistStream herda do IPersist. O IPersistStream também tem esses tipos de membros:

Métodos

A interface IPersistStream tem esses métodos.

 
IPersistStream::GetSizeMax

Recupera o tamanho do fluxo necessário para salvar o objeto. (IPersistStream.GetSizeMax)
IPersistStream::IsDirty

Determina se um objeto foi alterado desde que foi salvo pela última vez em seu fluxo. (IPersistStream.IsDirty)
IPersistStream::Load

Inicializa um objeto do fluxo em que ele foi salvo anteriormente. (IPersistStream.Load)
IPersistStream::Save

Salva um objeto no fluxo especificado. (IPersistStream.Save)

Comentários

Uma maneira pela qual essa interface é usada é dar suporte a implementações de moniker OLE. Cada uma das interfaces de moniker fornecidas pelo OLE fornece uma implementação IPersistStream por meio da qual o moniker salva ou carrega a si mesmo. Uma instância da classe de moniker composto genérico OLE chama os métodos IPersistStream de seus monikers de componente para carregar ou salvar os componentes na sequência adequada em um único fluxo.

Implementação do Moniker de URL IPersistStream

A implementação do moniker de URL de IPersistStream é encontrada em um objeto moniker de URL, que dá suporte a IUnknown, IAsyncMoniker e IMoniker. A interface IMoniker herda sua definição de IPersistStream e, portanto, o moniker de URL também fornece uma implementação de IPersistStream como parte de sua implementação do IMoniker.

A interface IAsyncMoniker em um moniker de URL é simplesmente IUnknown (não há métodos adicionais); ele é usado para permitir que os clientes determinem se um moniker dá suporte à associação assíncrona. Para obter um ponteiro para a interface IMoniker nesse objeto, chame a função CreateURLMonikerEx . Em seguida, para obter um ponteiro para IPersistStream, chame o método QueryInterface .

IPersistStream, além de herdar sua definição de IUnknown, também herda o único método de IPersist, GetClassID.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h

Confira também

Imoniker

Ipersiststreaminit