Función OleSaveToStream (ole.h)
Guarda un objeto con la interfaz IPersistStream en él en la secuencia especificada.
Sintaxis
OLESTATUS OleSaveToStream(
LPOLEOBJECT unnamedParam1,
LPOLESTREAM unnamedParam2
);
Parámetros
unnamedParam1
Puntero a la interfaz IPersistStream del objeto que se va a guardar en la secuencia. El parámetro pPStm no puede ser NULL.
unnamedParam2
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 incluyen lo siguiente.
| 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 del 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 | ole.h (incluya 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) |