IApplicationDestinations::Metode SetAppID (shobjidl_core.h)
Menentukan ID Model Pengguna Aplikasi yang unik (AppUserModelID) untuk aplikasi yang tombol taskbar-nya Jump List metode antarmuka ini akan menghapus tujuan. Metode ini bersifat opsional.
Sintaks
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parameter
[in] pszAppID
Jenis: LPCWSTR
Arahkan ke AppUserModelID dari proses yang representasi tombol taskbar-nya menerima Jump List.
Nilai kembali
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 RemoveAllDestinations atau RemoveDestination.
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 IApplicationDestinations::RemoveDestination atau IApplicationDestinations::RemoveAllDestinations 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) |