Función OleSave (ole2.h)

Guarda un objeto abierto en modo transaccionado en el objeto de almacenamiento especificado.

Sintaxis

HRESULT OleSave(
  [in] LPPERSISTSTORAGE pPS,
  [in] LPSTORAGE        pStg,
  [in] BOOL             fSameAsLoad
);

Parámetros

[in] pPS

Puntero a la interfaz IPersistStorage en el objeto que se va a guardar.

[in] pStg

Puntero a la interfaz IStorage en el objeto de almacenamiento de destino al que se va a guardar el objeto indicado en pPS .

[in] fSameAsLoad

TRUE indica que pStg es el mismo objeto de almacenamiento desde el que se cargó o creó el objeto; FALSE indica que pStg se cargó o creó a partir de un objeto de almacenamiento diferente.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Comentarios

La función auxiliar OleSave controla la situación común en la que un objeto está abierto en modo de transacción y, a continuación, se guarda en el objeto de almacenamiento especificado que usa la implementación del archivo compuesto proporcionado por OLE. El modo de transacción significa que los cambios en el objeto se almacenan en búfer hasta que se llame a IStorage::Commit o IStorage::Revert . Los autores de llamadas pueden controlar otras situaciones llamando directamente a las interfaces IPersistStorage e IStorage .

OleSave hace lo siguiente:

• Llama al método IPersist::GetClassID para obtener el CLSID del objeto.
• Escribe el CLSID en el objeto de almacenamiento mediante la función WriteClassStg .
• Llama al método IPersistStorage::Save para guardar el objeto.
• Si no hubo errores en el guardado; llama al método IStorage::Commit para confirmar los cambios.

Requisitos

Consulte también

IPersistStorage

IStorage