共用方式為


ICustomDestinationList::D eleteList 方法 (shobjidl_core.h)

刪除指定應用程式的自訂跳躍清單。

語法

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

參數

[in] pszAppID

類型: LPCWSTR

應用程式的 AppUserModelID 指標,其工作列按鈕標記法會顯示自訂快捷方式清單。 在 Windows 7 的 Beta 版本中,必須明確提供這個 AppUserModelID,因為這個方法是要從卸載程式呼叫,這會在不同的進程中執行。 因為它是在不同的進程中,所以系統無法可靠地推算 AppUserModelID。 此限制預期會在更新版本中移除。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

有數個應該呼叫此方法的實例,包括:

  • 卸載應用程式時。
  • 當使用者從應用程式內清除歷程記錄時。
  • 當使用者在應用程式的 [設定] 或 [選項] 頁面中停用目的地追蹤時。
當應用程式更新自訂目的地清單時,不應該呼叫這個方法。 它只會用來在卸載作業期間完全清除清單,或應用程式提供選項讓使用者關閉清單。

移除自訂跳躍清單之後,會顯示從系統為最近使用的專案產生的標準跳躍清單。 如果未收集任何這類資料,或已透過 RemoveAllDestinations清除資訊,跳躍清單可能只包含其最小值、一律會顯示內容:用來釘選或取消釘選的標準工作、啟動應用程式的新實例,或關閉視窗。

規格需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
程式庫 Shell32.lib
Dll Shell32.dll (6.1 版或更新版本)

另請參閱

應用程式使用者模型識別碼 (AppUserModelIDs)

ICustomDestinationList

ICustomDestinationList::SetAppID

工作列延伸模組