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::RemoveAllDestinations