ICustomDestinationList：：SetAppID 方法 (shobjidl_core.h)

指定應用程式的唯一應用程式使用者模型標識碼 (AppUserModelID) ，其任務欄按鈕會保存透過這個介面的方法所建置的自定義跳躍清單。這個方法是一個選擇項目。

語法

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

[in] pszAppID

類型： LPCWSTR

進程或應用程式 AppUserModelID 的指標，其任務列表示法會接收跳躍清單。

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值，包括下列專案：

傳回碼	Description
E_UNEXPECTED	這個方法是在 ICustomDestinationList：：BeginList 之後呼叫。清單建置程式已經在使用特定的 AppUserModelID 執行，由系統推斷，或透過呼叫 SetAppID ，再呼叫 BeginList。在進行清單建置作業之後，必須先呼叫 CommitList 或 AbortList 之後，才能變更 AppUserModelID。

如果應用程式具有明確的 AppUserModelID，您必須先呼叫 SetAppID ，才能呼叫 ICustomDestinationList：：BeginList 或 ICustomDestinationList：：GetRemovedDestinations。

透過物件的 SetAppID 方法指定 AppUserModelID 之後，AppUserModelID 會儲存在該物件的存留期內，前提是該物件的存留期不會被另一個呼叫 SetAppID 覆寫。

某些應用程式不會宣告明確的 AppUserModelID，而且不應該呼叫此方法。在此情況下，呼叫 ICustomDestinationList：：BeginList 或 ICustomDestinationList：：GetRemovedDestinations 時，會推斷應用程式的身分識別。不過，避免這些計算有效能優勢，因此鼓勵提供自定義 Jump 清單的應用程式使用明確的 AppUserModelID。