共用方式為


IApplicationDocumentLists::SetAppID 方法 (shobjidl_core.h)

為擷取目的地清單的應用程式指定唯一的應用程式使用者模型識別碼 (AppUserModelID) 。 這個方法是一個選擇項目。

語法

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

參數

[in] pszAppID

類型: LPCWSTR

工作列按鈕標記法接收跳躍清單之進程的 AppUserModelID 指標。

傳回值

類型: HRESULT

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

備註

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

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

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

規格需求

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

另請參閱

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

IApplicationDocumentLists

工作列延伸模組