OleLoadFromStream-Funktion (ole2.h)

Artikel
02/29/2024

Lädt ein -Objekt aus dem Stream.

Syntax

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

Parameter

[in] pStm

Zeiger auf die IStream-Schnittstelle des Datenstroms, aus dem das Objekt geladen werden soll.

[in] iidInterface

Interface Identifier (IID), die der Aufrufer verwenden möchte, um nach dem Laden mit dem Objekt zu kommunizieren.

[out] ppvObj

Adresse der Zeigervariablen, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvObj den angeforderten Schnittstellenzeiger für das neu geladene Objekt.

Rückgabewert

Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher für den Vorgang.
E_NOINTERFACE	Das -Objekt unterstützt die angegebene Schnittstelle nicht.

Diese Funktion kann auch alle Fehlerwerte zurückgeben, die von den Funktionen ReadClassStm und CoCreateInstance und der IPersistStream::Load-Methode zurückgegeben werden.

Hinweise

Wichtig

Sicherheitshinweis: Das Aufrufen dieser Methode mit nicht vertrauenswürdigen Daten ist ein Sicherheitsrisiko. Rufen Sie diese Methode nur mit vertrauenswürdigen Daten auf.

Diese Funktion kann verwendet werden, um ein Objekt zu laden, das die IPersistStream-Schnittstelle unterstützt. Die CLSID des Objekts muss unmittelbar den Daten des Objekts im Stream vorangestellt werden, was durch die Begleitfunktion OleSaveToStream erreicht wird (oder die Vorgänge, die in diesem Thema beschrieben werden).

Wenn die CLSID für den Stream CLSID_NULL ist, wird der ppvObj-Parameter auf NULL festgelegt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ole2.h (Ole2.h einschließen)
Bibliothek	Ole32.lib
DLL	Ole32.dll
APIs	ext-ms-win-com-ole32-l1-1-5 (eingeführt in Windows 10, Version 10.0.15063)

Weitere Informationen

OleSaveToStream

Freigeben über