Metode IApplicationDocumentLists::SetAppID (shobjidl_core.h)
Menentukan ID Model Pengguna Aplikasi unik (AppUserModelID) untuk aplikasi yang daftar tujuannya sedang diambil. Metode ini bersifat opsional.
Sintaks
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parameter
[in] pszAppID
Jenis: LPCWSTR
Penunjuk ke AppUserModelID dari proses yang representasi tombol taskbar-nya menerima Jump List.
Menampilkan nilai
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Jika aplikasi memiliki AppUserModelID eksplisit, metode ini harus dipanggil sebelum Anda memanggil GetList.
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 IApplicationDocumentLists::GetList dipanggil. Namun, ada manfaat performa dalam menghindari perhitungan tersebut, sehingga aplikasi yang menyediakan Jump List kustom didorong untuk menggunakan AppUserModelIDs eksplisit.
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 | shobjidl_core.h (termasuk Shobjidl.h) |
| Pustaka | Shell32.lib |
| DLL | Shell32.dll (versi 6.1 atau yang lebih baru) |