IApplicationDestinations::SetAppID 方法 (shobjidl_core.h)
為應用程式指定唯一的應用程式使用者模型標識碼 (AppUserModelID) ,其任務欄按鈕的 [跳躍清單] 會移除此介面的方法。 這個方法是一個選擇項目。
語法
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
參數
[in] pszAppID
類型: LPCWSTR
任務欄按鈕表示法接收跳躍清單之進程的 AppUserModelID 指標。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
如果應用程式具有明確的 AppUserModelID,您必須先呼叫這個方法,才能呼叫 RemoveAllDestinations 或 RemoveDestination。
透過物件的 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 版或更新版本) |