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
E_UNEXPECTED	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)

ICustomDestinationList

SetCurrentProcessExplicitAppUserModelID

Ekstensi Bilah Tugas