IOleDocumentView::SaveViewState-Methode (docobj.h)

Speichert den Ansichtszustand im angegebenen Stream.

Syntax

HRESULT SaveViewState(
  [in] LPSTREAM pstm
);

Parameter

[in] pstm

Ein Zeiger auf den Datenstrom, in dem die Ansicht ihre Zustandsdaten speichern soll.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_POINTER	Der Wert in pstm ist NULL.
E_NOTIMPL	Diese Ansicht hat keinen aussagekräftigen Zustand zum Speichern. Dieser Fehler sollte selten sein, da die meisten Ansichten mindestens einige Zustandsinformationen enthalten, die gespeichert werden sollten.

Hinweise

Der Zustand der Ansicht umfasst Eigenschaften wie Ansichtstyp, Zoomfaktor und Position der Einfügemarke. Der Container ruft diese Funktion in der Regel auf, bevor die Ansicht deaktiviert wird. Der Stream kann dann später verwendet werden, um eine Ansicht desselben Dokuments über IOleDocumentView::ApplyViewState in diesen gespeicherten Zustand neu zu initialisieren.

Gemäß den Regeln für IPersistStream muss eine Ansicht ihre CLSID als erstes Element im Stream schreiben. Alle probleme mit der kompatibilität des plattformübergreifenden Dateiformats, die sich auf die Speicherdarstellung des Dokuments beziehen, gelten auch für diesen Kontext.

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

Weitere Informationen

IOleDocumentView

IOleDocumentView::ApplyViewState

Ipersiststream