OleLoadFromStream-Funktion (ole2.h)

  • Artikel

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