Bagikan melalui

Fungsi SHGetPropertyStoreForWindow (shellapi.h)

  • Artikel

Mengambil objek yang mewakili kumpulan properti jendela tertentu, yang memungkinkan properti tersebut untuk dikueri atau diatur.

Sintaks

SHSTDAPI SHGetPropertyStoreForWindow(
  [in]  HWND   hwnd,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] hwnd

Jenis: HWND

Handel ke jendela yang propertinya sedang diambil.

[in] riid

Jenis: REFIID

Referensi ke IID objek penyimpanan properti untuk diambil melalui ppv. Ini biasanya IID_IPropertyStore.

[out] ppv

Jenis: batal**

Ketika fungsi ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IPropertyStore.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Aplikasi dapat menggunakan fungsi ini untuk mendapatkan akses ke penyimpanan properti jendela sehingga dapat mengatur ID Model Pengguna Aplikasi eksplisit (AppUserModelID) di properti System.AppUserModel.ID .

Properti jendela harus dihapus sebelum jendela ditutup. Jika ini tidak dilakukan, sumber daya yang digunakan oleh properti tersebut tidak dikembalikan ke sistem. Properti dihapus dengan mengaturnya ke jenis PROPVARIANT VT_EMPTY.

Ketika panggilan dilakukan ke IPropertyStore::SetValue pada objek yang diambil melalui ppv, properti dan nilai segera disimpan di jendela. Oleh karena itu, tidak diperlukan panggilan ke IPropertyStore::Commit . Tidak ada kesalahan yang terjadi jika dipanggil, tetapi tidak berpengaruh.

Aplikasi menetapkan AppUserModelIDs pada jendela individual untuk mengontrol pengelompokan taskbar aplikasi dan konten Jump List. Misalnya, aplikasi suite mungkin ingin menyediakan tombol taskbar yang berbeda untuk setiap subfeaturnya, dengan jendela yang berkaitan dengan subfeature yang dikelompokkan di bawah tombol tersebut. Tanpa AppUserModelIDs tingkat jendela, semua jendela tersebut akan dikelompokkan bersama di bawah proses utama.

Aplikasi juga harus menggunakan penyimpanan properti ini untuk mengatur properti relaunch ini sehingga sistem dapat mengembalikan aplikasi ke status tersebut.

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header shellapi.h
Pustaka Shell32.lib
DLL Shell32.dll (versi 6.1 atau yang lebih baru)

Lihat juga

ID Model Pengguna Aplikasi (AppUserModelIDs)