IApplicationDestinations 介面 (shobjidl_core.h)

公開方法，允許應用程式從跳躍清單中的 [最近 ] 或 [ 常用 ] 類別中移除一或所有目的地。

繼承

IApplicationDestinations 介面繼承自 IUnknown 介面。 IApplicationDestinations 也有下列類型的成員：

方法

IApplicationDestinations 介面具有這些方法。

IApplicationDestinations：：RemoveAllDestinations 清除應用程式快捷方式清單中的 [最近] 和 [常用] 類別中的所有目的地專案。
IApplicationDestinations：：RemoveDestination 從跳躍清單中的 [最近] 和 [常用] 類別中移除單一目的地。
IApplicationDestinations：：SetAppID 為應用程式指定唯一的應用程式使用者模型標識碼 (AppUserModelID) ，其任務欄按鈕的 [跳躍清單] 會移除此介面的方法。 這個方法是一個選擇項目。

備註

何時實作

此介面的實作會在 Windows 中提供作為CLSID_ApplicationDestinations。 第三方不會實作此介面。

使用時機

當應用程式想要從 Jump List 自動產生的目的地中移除專案時，會呼叫這個介面的方法。 在 [最近] 或 [ 常用 ] 類別中找到的這些目的地是透過呼叫 SHAddToRecentDocs來產生，不論是透過Windows 檔案總管開啟檔案，或是使用通用檔案對話框來開啟、儲存或建立檔案時，由系統明確產生。

在下列情況下，應用程式應該呼叫 IApplicationDestinations 方法：

• 卸載應用程式時。
• 當使用者清除歷程記錄時。
• 當使用者在應用程式的 [設定] 或 [選項] 頁面中停用目的地追蹤時。
• 當使用者從應用程式內刪除目的地時。 這在目的地不是檔案的情況下特別重要。 在非檔案目的地的情況下，一般而言，雖然不一定是 IShellLink 專案，但在偵測到目的地不存在時，應用程式必須負責從清單中移除目的地。

如果使用者在應用程式的隱私權設定中關閉使用量追蹤，應用程式會負責清除現有的數據，同時停止系統在未來收集該專案上的使用量數據。 這是透過在所有應用程式的檔類型註冊中設定 NoRecentDocs 值來完成。 如需詳細資訊 ，請參閱FTA_NoRecentDocs 。

IApplicationDestinations 方法只能與自動產生的 [最近 ] 或 [ 常用 ] 類別搭配使用。 他們不會移除使用者已釘選到跳躍清單的專案。 這些項目無法以程式設計方式移除;只有使用者可以移除它們。 這些方法也不會影響 自定義類別 或工作清單。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)

另請參閱

任務列延伸模組