Metode IShellBrowser::GetViewStateStream (shobjidl_core.h)

Artikel
03/02/2024

Mendapatkan antarmuka IStream yang dapat digunakan untuk penyimpanan informasi status khusus tampilan.

Sintaks

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

Parameter

grfMode

Jenis: DWORD

Akses baca/tulis antarmuka IStream . Ini mungkin salah satu nilai berikut.

STGM_READ

Meminta IStream yang cocok untuk dibaca.

STGM_WRITE

Meminta IStream yang cocok untuk menulis.

STGM_READWRITE

Meminta IStream yang cocok untuk membaca dan menulis.

ppStrm

Jenis: IStream**

Alamat yang menerima penunjuk antarmuka IStream .

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan yang ditentukan COM jika tidak.

Keterangan

Metode ini digunakan untuk menyimpan dan memulihkan status persisten untuk tampilan (posisi ikon, lebar kolom, dan posisi gulir saat ini, misalnya).

Catatan untuk Memanggil Aplikasi

Gunakan GetViewStateStream saat tampilan sedang dibuat untuk dibaca dalam status tampilan tersimpan dan juga saat tampilan ditutup untuk menyimpan perubahan apa pun ke status tampilan. Biasanya, tampilan memanggil metode ini dengan STGM_READ saat membuat jendela tampilan dan dengan STGM_WRITE ketika metode SaveViewState antarmuka IShellView-nya dipanggil.

Catatan untuk Pelaksana

Setiap tampilan Shell harus memiliki aliran tampilannya sendiri. Windows Explorer mengimplementasikan daftar aliran tampilan yang terakhir digunakan (MRU) yang disimpan per pengguna dalam registri.

Lihat juga IShellBrowser

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)

Bagikan melalui