OleSaveToStream

9/8/2008

Essa função Salva um objeto com o IPersistStream:IPersist interface nele para transmitir o especificado.

Syntax

WINOLEAPI OleSaveToStream(
  IPersistStream* pPStm,
  IStream* pStm 
);

Parameters

• pPStm
  [no] Ponteiro para o IPersistStream interface sobre o objeto para serem salvos na transmitir.

  O pPStm parâmetro não pode ser NULL.

• pStm
  [no] Ponteiro para o IStream interface sobre a transmitir que o objeto deve ser salvo no.

Return Value

O seguinte valores HRESULT podem ser retornados.

Valor	Descrição
S_OK	O objeto foi salvo.
OLE_E_BLANK	O pPStm parâmetro é NULL.
STG_E_MEDIUMFULL	Não há nenhum espaço deixadas no dispositivo para salvar o objeto.

Essa função também pode retornar qualquer valor de erro retornado pelo WriteClassStm função ou a IPersistStream::Save método.

Remarks

Essa função simplifica Salvar um objeto que implementa o IPersistStream interface para um transmitir. Nesta do transmitir, o objeto CLSID precede seus dados. Quando a transmitir é recuperada, o CLSID permite a codificar adequado seja associado com os dados.

O OleSaveToStream função faz o seguinte:

• Chamadas de IPersistStream::GetClassID método para get o objeto é CLSID.
• Grava o CLSID a transmitir com o WriteClassStm função.
• Chamadas de IPersistStream::Save método com fClearDirty Definir como TRUE, que limpa o bit sujo no objeto.

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

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	ole2.h
Library	ole32.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
IPersistStream
IStream
WriteClassStm
IPersistStream::Save
WriteClassStm
OleLoadFromStream

Concepts

Determining Supported COM APIs