Share via


IApplicationDestinations::SetAppID 方法 (shobjidl_core.h)

為應用程式指定唯一的應用程式使用者模型標識碼 (AppUserModelID) ,其任務欄按鈕的 [跳躍清單] 會移除此介面的方法。 這個方法是一個選擇項目。

語法

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

參數

[in] pszAppID

類型: LPCWSTR

任務欄按鈕表示法接收跳躍清單之進程的 AppUserModelID 指標。

傳回值

類型: HRESULT

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

備註

如果應用程式具有明確的 AppUserModelID,您必須先呼叫這個方法,才能呼叫 RemoveAllDestinationsRemoveDestination

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

某些應用程式不會宣告明確的 AppUserModelID,而且不應該呼叫這個方法。 在此情況下,呼叫IApplicationDestinations::RemoveDestinations::RemoveDestinations::RemoveAllDestinations 時,就會推斷應用程式的身分識別。 不過,避免這些計算會有效能優勢,因此建議提供自定義 Jump 清單 的應用程式使用明確的 AppUserModelID。

規格需求

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

另請參閱

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

IApplicationDestinations

任務列延伸模組