Metode ICustomDestinationList::GetRemovedDestinations (shobjidl_core.h)

Mengambil daftar tujuan saat ini yang telah dihapus oleh pengguna dari Jump List yang ada yang dimaksudkan untuk diganti oleh Jump List kustom ini.

Sintaks

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppv, biasanya IID_IObjectArray.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya merupakan IObjectArray, yang mewakili kumpulan objek IShellItem atau IShellLink yang mewakili item dalam daftar tujuan yang dihapus.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Item dapat dihapus dari UI Jump List melalui tindakan pengguna. Item kemudian ditandai sebagai dihapus dan tidak lagi ditampilkan. Aplikasi dapat menggunakan metode ini untuk memberi tahu item mana yang telah dihapus pengguna sehingga tahu untuk tidak menampilkannya dalam daftar kustomnya. Misalnya, metode ini harus dipanggil ketika aplikasi diluncurkan, jika aplikasi tersebut tidak akan menghasilkan daftar baru melalui ICustomDestinationList::BeginList.

Sangat disarankan agar aplikasi menghapus data pelacakan tujuan apa pun ketika pengguna memilih untuk menghapus tujuan tersebut. Jika pengguna mengakses tujuan tersebut lagi di masa mendatang, itu mungkin ditambahkan kembali ke Jump List dan dapat kembali mengakumulasi data. Daftar tujuan yang dihapus yang sama yang diambil oleh metode ini diambil ketika ICustomDestinationList::BeginList dipanggil. Dalam hal ini, aplikasi tidak boleh segera mencoba memasukkan kembali item yang dihapus atau panggilan ke AppendCategory akan gagal. Ini memastikan bahwa aplikasi menghormati niat pengguna untuk menghapus item.

Jika aplikasi memiliki ID Model Pengguna Aplikasi eksplisit (AppUserModelID), Anda harus memanggil SetAppID sebelum memanggil metode ini.

Bahkan jika aplikasi memanggil GetRemovedDestinations dan menemukan item dalam daftar yang memiliki probabilitas tinggi untuk dipulihkan ke Jump List lebih cepat dari Jump List kustom baru diharapkan dibuat, aplikasi harus menulis Jump List tanpa item tersebut dan menambahkannya kembali ke daftar hanya setelah pengguna kembali mengaksesnya.

Aplikasi dapat menambahkan kategori Terbaru atau Seringdiketahui ke Jump List kustomnya. Item dalam kategori tersebut mungkin ada dalam daftar item yang dihapus meskipun tidak ditampilkan dalam kategori kustom apa pun. Dalam hal ini, aplikasi masih harus menghapus data penggunaan apa pun untuk item tersebut jika ada yang telah disimpan.

Panggilan ke GetRemovedDestinations tidak menghapus data tujuan yang dihapus. Data ini diperlukan oleh BeginList untuk pembuatan daftar berikutnya. Data tujuan yang dihapus tidak lagi diperlukan dan dibersihkan setelah sesi pembuatan daftar dimulai oleh BeginList, dilanjutkan tanpa panggilan yang gagal ke AppendCategory, dan diselesaikan dengan panggilan ke CommitList.

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

ICustomDestinationList

ICustomDestinationList::BeginList

Ekstensi Taskbar