Fungsi SHGetPropertyStoreForWindow (shellapi.h)
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.
- System.AppUserModel.RelaunchCommand
- System.AppUserModel.RelaunchDisplayNameResource
- System.AppUserModel.RelaunchIconResource
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) |