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:

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