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 |
|---|---|
|
No se pudo guardar el objeto debido a la falta de espacio en disco. |
|
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 .
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) |