Método IPersistStreamInit::Save (ocidl.h)

  • Artículo

Guarda un objeto en la secuencia especificada.

Sintaxis

HRESULT Save(
  [in] LPSTREAM pStm,
  [in] BOOL     fClearDirty
);

Parámetros

[in] pStm

Puntero IStream a la secuencia en la que se debe guardar el objeto.

[in] fClearDirty

Indica si se borrará o no la marca de modificado después de completarse el proceso de guardado. Si es TRUE, se debe borrar la marca. Si es FALSE, la marca debe dejarse sin cambios.

Valor devuelto

Este método puede devolver los valores siguientes.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
STG_E_CANTSAVE
 El objeto no se pudo guardar en la secuencia. Este error podría indicar, por ejemplo, que el objeto contiene otro objeto que no se puede serializar en una secuencia o que una llamada ISequentialStream::Write devolvió STG_E_CANTSAVE.
STG_E_MEDIUMFULL
 No se pudo guardar el objeto porque no queda espacio en el dispositivo de almacenamiento.

Comentarios

IPersistStreamInit::Save guarda un objeto en la secuencia especificada e indica si el objeto debe restablecer su marca desfasada.

El puntero de búsqueda se coloca en la ubicación de la secuencia en la que el objeto debe empezar a escribir sus datos. El objeto llama al método ISequentialStream::Write para escribir sus datos.

Al salir, el puntero de búsqueda debe colocarse inmediatamente después de los datos del objeto. La posición del puntero de búsqueda no está definida si se devuelve un error.

Notas para los implementadores

El método IPersistStreamInit::Save no escribe el CLSID en la secuencia. El autor de la llamada es responsable de escribir el CLSID.

El método IPersistStreamInit::Save puede leer, escribir en y buscar en la secuencia; pero no debe buscar una ubicación en la secuencia antes de que el puntero de búsqueda en la entrada.

Requisitos

   
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 ocidl.h

Consulte también

IPersistStreamInit