Funzione OleSaveToStream (ole.h)

Articolo
03/15/2023

Salva un oggetto con l'interfaccia IPersistStream sul flusso specificato.

Sintassi

OLESTATUS OleSaveToStream(
  LPOLEOBJECT unnamedParam1,
  LPOLESTREAM unnamedParam2
);

Parametri

unnamedParam1

Puntatore all'interfaccia IPersistStream nell'oggetto da salvare nel flusso. Il parametro pPStm non può essere NULL.

unnamedParam2

Puntatore all'interfaccia IStream nel flusso in cui salvare l'oggetto.

Valore restituito

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

Codice restituito	Descrizione
STGMEDIUM_E_FULL	Impossibile salvare l'oggetto a causa della mancanza di spazio su disco.
OLE_E_BLANK	Il parametro pPStm è NULL.

Questa funzione può anche restituire uno dei valori di errore restituiti dalla funzione WriteClassStm o dal metodo IPersistStream::Save .

Commenti

Questa funzione semplifica il salvataggio di un oggetto che implementa l'interfaccia IPersistStream in un flusso. In questo flusso il CLSID dell'oggetto precede i dati. Quando il flusso viene recuperato, CLSID consente di associare il codice corretto ai dati. La funzione OleSaveToStream esegue le operazioni seguenti:

Chiama il metodo IPersist::GetClassID per ottenere il CLSID dell'oggetto.
Scrive il CLSID nel flusso con la funzione WriteClassStm .
Chiama il metodo IPersistStream::Save con fClearDirty impostato su TRUE, che cancella il bit dirty nell'oggetto.

L'helper complementare , OleLoadFromStream, carica gli oggetti salvati in questo modo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole.h (include Ole2.h)
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-1 (introdotto in Windows 8.1)

Vedi anche

Ipersiststream

IStream

OleLoadFromStream

Condividi tramite