Función OleSaveToStream (ole2.h)

Guarda un objeto con la interfaz IPersistStream en él en la secuencia especificada.

Sintaxis

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

Parámetros

[in] pPStm

Puntero a la interfaz IPersistStream del objeto que se va a guardar en la secuencia. El parámetro pPStm no puede ser NULL.

[in] pStm

Puntero a la interfaz IStream de la secuencia en la que se va a guardar el objeto.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son los siguientes.

Código devuelto	Descripción
STGMEDIUM_E_FULL	No se pudo guardar el objeto debido a la falta de espacio en disco.
OLE_E_BLANK	El parámetro pPStm es NULL.

 

Esta función también puede devolver cualquiera de los valores de error devueltos por la función WriteClassStm o el método IPersistStream::Save .

Comentarios

Esta función simplifica el guardado de un objeto que implementa la interfaz IPersistStream en una secuencia. En esta secuencia, el CLSID del objeto precede a sus datos. Cuando se recupera la secuencia, clSID permite asociar el código adecuado a los datos. La función OleSaveToStream hace lo siguiente:

• Llama al método IPersist::GetClassID para obtener el CLSID del objeto.
• Escribe el CLSID en la secuencia con la función WriteClassStm .
• Llama al método IPersistStream::Save con fClearDirty establecido en TRUE, que borra el bit sucio en el objeto .

El asistente complementario , OleLoadFromStream, carga objetos guardados de esta manera.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ole2.h (include Ole2.h)
Library	Ole32.lib
Archivo DLL	Ole32.dll
Conjunto de API	ext-ms-win-com-ole32-l1-1-1 (introducido en Windows 8.1)

Consulte también

Ipersiststream

Istream

OleLoadFromStream