Share via

Metode ICustomDestinationList::D eleteList (shobjidl_core.h)

  • Artikel

Menghapus Jump List kustom untuk aplikasi tertentu.

Sintaks

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

Parameter

[in] pszAppID

Jenis: LPCWSTR

Penunjuk ke AppUserModelID dari proses yang representasi tombol taskbar-nya menampilkan Jump List kustom. Dalam rilis beta Windows 7, AppUserModelID ini harus disediakan secara eksplisit karena metode ini dimaksudkan untuk dipanggil dari uninstaller, yang berjalan dalam proses terpisah. Karena dalam proses terpisah, sistem tidak dapat menyimpulkan AppUserModelID dengan andal. Pembatasan ini diperkirakan akan dihapus dalam rilis selanjutnya.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ada beberapa contoh di mana metode ini harus dipanggil, termasuk:

  • Ketika aplikasi dihapus instalannya.
  • Ketika pengguna menghapus riwayat dari dalam aplikasi.
  • Saat pengguna menonaktifkan pelacakan tujuan di halaman Pengaturan atau Opsi aplikasi.
Metode ini tidak boleh dipanggil ketika aplikasi memperbarui daftar tujuan kustom. Ini hanya digunakan untuk menghapus daftar sepenuhnya selama operasi penghapusan instalasi, atau jika aplikasi menyediakan opsi bagi pengguna untuk menonaktifkan daftar.

Setelah Jump List kustom dihapus, Jump List standar yang dihasilkan dari data yang dihasilkan sistem untuk item yang baru digunakan ditampilkan. Jika tidak ada data yang dikumpulkan atau jika informasi telah dihapus melalui RemoveAllDestinations, Jump List mungkin hanya berisi konten minimum, selalu ada: tugas standar untuk menyematkan atau melepaskan sematan, meluncurkan instans baru aplikasi, atau menutup jendela.

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)

Lihat juga

ID Model Pengguna Aplikasi (AppUserModelIDs)

ICustomDestinationList

ICustomDestinationList::SetAppID

Ekstensi Taskbar