Metode ICustomDestinationList::SetAppID (shobjidl_core.h)
Menentukan ID Model Pengguna Aplikasi (AppUserModelID) unik untuk aplikasi yang tombol taskbar-nya akan menyimpan Jump List kustom yang dibangun melalui metode antarmuka ini. Metode ini bersifat opsional.
Sintaks
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parameter
[in] pszAppID
Jenis: LPCWSTR
Penunjuk ke AppUserModelID dari proses atau aplikasi yang representasi taskbar-nya menerima Jump List.
Menampilkan nilai
Jenis: HRESULT
Mengembalikan S_OK jika berhasil, atau nilai kesalahan jika tidak, termasuk yang berikut ini:
| Menampilkan kode | Deskripsi |
|---|---|
|
Metode ini dipanggil setelah ICustomDestinationList::BeginList. Proses pembuatan daftar sudah berjalan dengan AppUserModelID tertentu, baik disimpulkan oleh sistem atau diatur melalui panggilan ke SetAppID sebelum panggilan ke BeginList. Setelah operasi pembuatan daftar sedang berlangsung, AppUserModelID tidak dapat diubah hingga setelah CommitList atau AbortList dipanggil. |
Keterangan
Jika aplikasi memiliki AppUserModelID eksplisit, Anda harus memanggil SetAppID sebelum memanggil ICustomDestinationList::BeginList atau ICustomDestinationList::GetRemovedDestinations.
Setelah AppUserModelID ditentukan melalui metode SetAppID objek, AppUserModelID disimpan dalam objek untuk masa pakai objek tersebut, asalkan tidak ditimpa oleh panggilan lain ke SetAppID.
Beberapa aplikasi tidak akan mendeklarasikan AppUserModelID eksplisit dan tidak boleh memanggil metode ini. Dalam hal ini, identitas aplikasi disimpulkan ketika ICustomDestinationList::BeginList atau ICustomDestinationList::GetRemovedDestinations dipanggil. Namun, ada manfaat performa dalam menghindari perhitungan tersebut, sehingga aplikasi yang menyediakan Jump Lists kustom didorong untuk menggunakan AppUserModelIDs eksplisit.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shobjidl_core.h (termasuk Shobjidl.h) |
| Pustaka | Shell32.lib |
| DLL | Shell32.dll (versi 6.1 atau yang lebih baru) |
Lihat juga
ID Model Pengguna Aplikasi (AppUserModelIDs)