Funzione OleSaveToStream (ole.h)

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:

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