Função OleSaveToStream (ole.h)

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

Sintaxe

OLESTATUS OleSaveToStream(
  LPOLEOBJECT unnamedParam1,
  LPOLESTREAM unnamedParam2
);

Parâmetros

unnamedParam1

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

unnamedParam2

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

Retornar valor

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

Código de retorno	Descrição
STGMEDIUM_E_FULL	O objeto não pôde ser salvo devido à falta de espaço em disco.
OLE_E_BLANK	O parâmetro pPStm é NULL.

 

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 .

O auxiliar complementar, OleLoadFromStream, carrega objetos salvos dessa maneira.

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	ole.h (inclua Ole2.h)
Biblioteca	Ole32.lib
DLL	Ole32.dll
Conjunto de APIs	ext-ms-win-com-ole32-l1-1-1 (introduzido em Windows 8.1)

Confira também

Ipersiststream

Istream

OleLoadFromStream