IApplicationDestinations::RemoveDestination method (shobjidl_core.h)

Menghapus satu tujuan dari kategori Terbaru dan Sering dalam Jump List.

Sintaks

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

Parameter

[in] punk

Jenis: IUnknown*

Penunjuk ke IShellItem atau IShellLink yang mewakili tujuan untuk dihapus.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM standar sebaliknya. Jika objek yang ditujukan oleh punk bukan IShellItem atau IShellLink, metode mengembalikan E_INVALIDARG.

Keterangan

Tujuan dapat muncul di kategori Terbaru dan Sering . Jika demikian, metode ini menghapus tujuan dari kedua kategori.

Jika item disematkan ke daftar oleh pengguna, item tidak dihapus tetapi data penggunaannya dibersihkan.

Aplikasi dapat memanggil RemoveDestination tanpa mengetahui apakah item yang diacu oleh punk saat ini ada dalam daftar. Jika tidak ada data yang ada pada item (dalam hal ini tidak ada dalam daftar Terbaru atau Sering ), metode ini tidak melakukan apa pun dan mengembalikan S_OK.

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

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

IApplicationDestinations

IApplicationDestinations::RemoveAllDestinations

IApplicationDestinations::SetAppID

Ekstensi Taskbar