Metode IExplorerBrowser::SetPropertyBag (shobjidl_core.h)

Artikel
03/04/2024

Mengatur nama tas properti.

Sintaks

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

Parameter

[in] pszPropertyBag

Jenis: LPCWSTR

Penunjuk ke string Unicode konstanta yang dihentikan null yang berisi nama tas properti. Lihat informasi status yang khusus untuk aplikasi klien disimpan (bertahan) menggunakan nama ini.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

ExplorerBrowser dapat mengambil properti yang disimpan di tas properti dengan memanggil fungsi SHGetViewStatePropertyBag. ExplorerBrowser menulis ke tas properti ini yang juga disimpan (bertahan) di registri. Persistensi terjadi secara otomatis ketika ExplorerBrowser menghancurkan tampilan saat ini, memulai navigasi, atau dihancurkan. Setelah salah satu peristiwa ini, ia menulis informasi tentang status tampilan jika telah dimodifikasi oleh pengguna.

Jika tidak ada properti yang disimpan, status tampilan default ExplorerBrowser akan digunakan. Status tampilan default adalah status tampilan yang telah ditetapkan pengguna untuk lokasi tertentu, atau jika status tampilan untuk lokasi belum diatur (tidak pernah dimodifikasi oleh pengguna), maka status tampilan default didasarkan pada templat untuk jenis file (misalnya, dokumen, musik, dan gambar) di lokasi tersebut. Semua jendela Explorer menggunakan urutan yang sama untuk menentukan status tampilan default.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui