IPersistStream::Load-Methode (objidl.h)

  • Artikel

Initialisiert ein -Objekt aus dem Stream, in dem es zuvor gespeichert wurde.

Syntax

HRESULT Load(
  [in] IStream *pStm
);

Parameter

[in] pStm

Ein IStream-Zeiger auf den Stream, aus dem das Objekt geladen werden soll.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY
 Das Objekt wurde aufgrund fehlenden Arbeitsspeichers nicht geladen.
E_FAIL
 Das Objekt wurde aus einem anderen Grund nicht geladen, aus einem anderen Grund als aus einem Mangel an Arbeitsspeicher.

Hinweise

Diese Methode lädt ein Objekt aus dem zugeordneten Stream. Der Suchzeiger wird wie in der letzten IPersistStream::Save-Methode festgelegt. Diese Methode kann den Stream suchen und aus diesem lesen, aber nicht in ihn schreiben.

Hinweise für Anrufer

Anstatt IPersistStream::Load direkt aufzurufen, führt die OleLoadFromStream-Funktion in der Regel folgende Aktionen aus:
  1. Ruft die ReadClassStm-Funktion auf, um den Klassenbezeichner aus dem Stream abzurufen.
  2. Ruft die CoCreateInstance-Funktion auf, um eine instance des -Objekts zu erstellen.
  3. Fragt die instance für IPersistStream ab.
  4. Ruft IPersistStream::Load auf.
Bei der OleLoadFromStream-Funktion wird davon ausgegangen, dass Objekte im Stream mit einem Klassenbezeichner gefolgt von den Objektdaten gespeichert werden. Dieses Speichermuster wird von der generischen, zusammengesetzten Monikerimplementierung verwendet, die von OLE bereitgestellt wird.

Wenn die Objekte nicht mit diesem Muster gespeichert werden, müssen Sie die Methoden separat selbst aufrufen.

URL-Moniker-Hinweise

Initialisiert einen URL-Moniker aus Daten innerhalb eines Datenstroms, der in der Regel zuvor dort gespeichert wurde, mithilfe des IPersistStream::Save (mit OleSaveToStream). Das Binärformat des URL-Monikers ist die URL-Zeichenfolge in Unicode (kann eine vollständige oder partielle URL-Zeichenfolge sein, weitere Informationen finden Sie unter CreateURLMonikerEx ). Dies wird als ULONG-Anzahl von Zeichen dargestellt, gefolgt von so vielen Unicode-Zeichen.

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 objidl.h

Weitere Informationen

Ipersiststream