Função OleSaveToStream (ole2.h)

Salva um objeto com a interface IPersistStream nele no fluxo especificado.

Sintaxe

HRESULT OleSaveToStream(
  [in] LPPERSISTSTREAM pPStm,
  [in] LPSTREAM        pStm
);

Parâmetros

[in] pPStm

Ponteiro para a interface IPersistStream no objeto a ser salvo no fluxo. O parâmetro pPStm não pode ser NULL.

[in] pStm

Ponteiro para a interface IStream no fluxo no qual o objeto deve ser salvo.

Retornar valor

Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem o seguinte.

Essa função também pode retornar qualquer um dos valores de erro retornados pela função WriteClassStm ou pelo método IPersistStream::Save .

Comentários

Essa função simplifica salvar um objeto que implementa a interface IPersistStream em um fluxo. Nesse fluxo, o CLSID do objeto precede seus dados. Quando o fluxo é recuperado, o CLSID permite que o código adequado seja associado aos dados. A função OleSaveToStream faz o seguinte:

• Chama o método IPersist::GetClassID para obter o CLSID do objeto.
• Grava o CLSID no fluxo com a função WriteClassStm .
• Chama o método IPersistStream::Save com fClearDirty definido como TRUE, o que limpa o bit sujo no objeto .

Requisitos

Confira também

Ipersiststream

Istream

OleLoadFromStream