Funzione OleLoadFromStream (ole2.h)

Articolo
02/29/2024

Carica un oggetto dal flusso.

Sintassi

HRESULT OleLoadFromStream(
  [in]  LPSTREAM pStm,
  [in]  REFIID   iidInterface,
  [out] LPVOID   *ppvObj
);

Parametri

[in] pStm

Puntatore all'interfaccia IStream nel flusso da cui deve essere caricato l'oggetto.

[in] iidInterface

Identificatore di interfaccia (IID) che il chiamante vuole usare per comunicare con l'oggetto dopo il caricamento.

[out] ppvObj

Indirizzo della variabile del puntatore che riceve il puntatore di interfaccia richiesto in riid. Al termine della restituzione, *ppvObj contiene il puntatore di interfaccia richiesto nell'oggetto appena caricato.

Valore restituito

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

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente per l'operazione.
E_NOINTERFACE	L'oggetto non supporta l'interfaccia specificata.

Questa funzione può anche restituire uno dei valori di errore restituiti dalle funzioni ReadClassStm e CoCreateInstance e il metodo IPersistStream::Load .

Commenti

Importante

Nota sulla sicurezza: la chiamata a questo metodo con dati non attendibili è un rischio per la sicurezza. Chiamare questo metodo solo con dati attendibili.

Questa funzione può essere usata per caricare un oggetto che supporta l'interfaccia IPersistStream . Il CLSID dell'oggetto deve precedere immediatamente i dati dell'oggetto nel flusso, che viene eseguito dalla funzione complementare OleSaveToStream o dalle operazioni di cui viene eseguito il wrapping, descritte in tale argomento.

Se il CLSID per il flusso è CLSID_NULL, il parametro ppvObj è impostato su NULL.

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	ole2.h (include Ole2.h)
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-5 (introdotto in Windows 10, versione 10.0.15063)

Vedi anche

OleSaveToStream

Condividi tramite