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)

Lihat juga

ID Model Pengguna Aplikasi (AppUserModelIDs)

IApplicationDestinations

Ekstensi Taskbar