IPersistStream
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa interface fornece métodos para salvar e carregar objetos que usam um serial simples transmitir para suas necessidades armazenamento. O IPersistStream interface herda sua definição a partir de IPersist interface e portanto a inclui a GetClassID método de IPersist.
Uma maneira na qual ele é usado é implementações moniker OLE suporte. Cada uma das interfaces do OLE-provided moniker fornece uma IPersistStream implementação através do qual o moniker salva ou carrega próprio.
Uma instância de genérico de OLE composição chamadas classe moniker de IPersistStream Métodos de seus monikers componente para carregar ou salvar os componentes a seqüência apropriada em um único transmitir.
Recipientes OLE com incorporado e objetos vinculados componente não usam essa interface; Eles usam a IPersistStorage interface em vez disso.
Quando a implementar
Implementar o IPersistStream interface em objetos que devem ser salvos em um transmitir simples.
Alguns objetos deste tipo são identificadores de origem e alguns controles OLE, embora em geral, usam controles de IPersistStreamInit interface, que tem os mesmos métodos como IPersistStream, com um método adicional, IPersistStreamInit::InitNew.
O IMoniker interface é derivado das IPersistStream interface, portanto, você deve implementar o IPersistStream interface se você estiver implementando uma nova classe moniker.
Quando usar
Chamar métodos IPersistStream de um aplicativo contêiner para salvar ou carregar objetos que são contidos em um transmitir simples.
Quando usado para salvar ou carregar monikers, aplicativos típicos não chamar os métodos diretamente, mas permitir que o manipulador link usar como padrão para fazer as chamadas para salvar e carregar os identificadores de origem que identificam a origem link.
Esses identificadores de origem são armazenados em um transmitir no armazenamento para o objeto vinculado. Se você estiver escrevendo um personalizado manipulador link para a classe de objetos, você faria chamar os métodos de IPersistStream Para implementar o manipulador link.
Métodos
A seguinte tabela mostra os métodos para esta interface na ordem que o compilador chama os métodos. Como todas as interfaces COM, essa interface herda os métodos para a IUnknown interface.
| Método IUnknown | Descrição |
|---|---|
Retorna os ponteiros para com suporte interfaces. |
|
Contagem de referência incrementos. |
|
Contagem de referência diminui. |
| Método IPersist | Descrição |
|---|---|
Retorna o identificador classe (CLSID) para o objeto componente. |
| Método IPersistStream | Descrição |
|---|---|
Verifica o objeto para que as alterações desde a última vez em que foi salvo. |
|
Inicializa um objeto a partir de transmitir onde ele foi salvo anteriormente. |
|
Salva um objeto para a transmitir especificado e indica se o objeto deverá redefinir seu sinalizador sujo. |
|
Return o tamanho em bytes da transmitir necessária para salvar o objeto. |
Remarks
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requisitos
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IMoniker
IPersist
IPersistStorage
IPersistStreamInit
IPersist::GetClassID
IPersistStreamInit::InitNew