IApplicationDestinations：：RemoveDestination 方法 (shobjidl_core.h)

從跳躍清單中的 [最近 ] 和 [ 常用 ] 類別中移除單一目的地。

語法

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

[in] punk

類型： IUnknown*

IShellItem 或 IShellLink 的指標，代表要移除的目的地。

類型： HRESULT

如果成功，則傳回S_OK，否則傳回標準 COM 錯誤值。如果 punk 所指向的物件不是 IShellItem 或 IShellLink，此方法會傳回E_INVALIDARG。

目的地可以同時出現在 [最近 ] 和 [ 常用 ] 類別中。如果是這種情況，這個方法會從這兩個類別中移除目的地。

如果使用者將專案釘選到清單，則不會移除該專案，但會清除其使用方式數據。

應用程式可以呼叫 RemoveDestination ，而不知道 punk 所指向的專案目前是否在清單中。如果專案上沒有任何現有數據 (在此情況下，它不在 [ 最近 ] 或 [ 常用 ] 清單中) ，則此方法不會執行任何動作，並傳回S_OK。

如果應用程式具有明確的應用程式使用者模型標識碼 (AppUserModelID) ，您必須先呼叫 IApplicationDestinations：：SetAppID ，才能呼叫此方法。