Funzione OleSaveToStream (ole2.h)

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

Sintassi

HRESULT OleSaveToStream(
  [in] LPPERSISTSTREAM pPStm,
  [in] LPSTREAM        pStm
);

Parametri

[in] pPStm

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

[in] pStm

Puntatore all'interfaccia IStream nel flusso in cui l'oggetto deve essere salvato.

Valore restituito

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

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, CLSID dell'oggetto precede i dati. Quando il flusso viene recuperato, CLSID consente l'associazione del codice appropriato ai dati. La funzione OleSaveToStream esegue le operazioni seguenti:

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

Requisiti

Vedi anche

Ipersiststream

IStream

OleLoadFromStream