IShellBrowser::GetViewStateStream-Methode (shobjidl_core.h)

Artikel
03/02/2024

Ruft eine IStream-Schnittstelle ab, die zum Speichern von ansichtsspezifischen Zustandsinformationen verwendet werden kann.

Syntax

HRESULT GetViewStateStream(
  DWORD   grfMode,
  IStream **ppStrm
);

Parameter

grfMode

Art: DWORD

Lese-/Schreibzugriff der IStream-Schnittstelle . Dies kann einer der folgenden Werte sein.

STGM_READ

Fordert einen zum Lesen geeigneten IStream an.

STGM_WRITE

Fordert einen zum Schreiben geeigneten IStream an.

STGM_READWRITE

Fordert einen IStream an, der zum Lesen und Schreiben geeignet ist.

ppStrm

Typ: IStream**

Die Adresse, die den IStream-Schnittstellenzeiger empfängt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls einen COM-definierten Fehlerwert.

Hinweise

Diese Methode wird verwendet, um den persistenten Zustand für eine Ansicht (z. B. die Symbolpositionen, die Spaltenbreiten und die aktuelle Bildlaufposition) zu speichern und wiederherzustellen.

Hinweise zum Aufrufen von Anwendungen

Verwenden Sie GetViewStateStream , wenn die Ansicht erstellt wird, um im Zustand der gespeicherten Ansicht zu lesen und auch, wenn die Ansicht geschlossen wird, um alle Änderungen am Ansichtszustand zu speichern. In der Regel ruft die Ansicht diese Methode mit STGM_READ beim Erstellen eines Ansichtsfensters und mit STGM_WRITE auf, wenn die SaveViewState-Methode ihrer IShellView-Schnittstelle aufgerufen wird.

Hinweise zu Implementierern

Jede Shellansicht sollte über einen eigenen Ansichtsstream verfügen. Windows Explorer implementiert eine Liste der zuletzt verwendeten Ansichtsdatenströme (MRU), die auf Benutzerbasis in der Registrierung gespeichert werden.

Siehe auch IShellBrowser

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über