Funzione OleSave (ole2.h)

Salva un oggetto aperto in modalità transazionata nell'oggetto di archiviazione specificato.

Sintassi

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

Parametri

[in] pPS

Puntatore all'interfaccia IPersistStorage nell'oggetto da salvare.

[in] pStg

Puntatore all'interfaccia IStorage nell'oggetto di archiviazione di destinazione a cui deve essere salvato l'oggetto indicato in pPS .

[in] fSameAsLoad

TRUE indica che pStg è lo stesso oggetto di archiviazione da cui è stato caricato o creato l'oggetto; FALSE indica che pStg è stato caricato o creato da un oggetto di archiviazione diverso.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Commenti

La funzione helper OleSave gestisce la situazione comune in cui un oggetto è aperto in modalità transazionata e quindi deve essere salvato nell'oggetto di archiviazione specificato che usa l'implementazione del file composto fornito da OLE. La modalità transacted indica che le modifiche apportate all'oggetto vengono memorizzate nel buffer fino a quando non viene chiamato uno dei tipi IStorage::Commit o IStorage::Revert. I chiamanti possono gestire altre situazioni chiamando direttamente le interfacce IPersistStorage e IStorage .

OleSave esegue le operazioni seguenti:

• Chiama il metodo IPersist::GetClassID per ottenere CLSID dell'oggetto.
• Scrive CLSID nell'oggetto di archiviazione usando la funzione WriteClassStg .
• Chiama il metodo IPersistStorage::Save per salvare l'oggetto.
• Se non sono presenti errori nel salvataggio; chiama il metodo IStorage::Commit per eseguire il commit delle modifiche.

Requisiti

Vedi anche

IPersistStorage

IStorage