Share via


SetCurrentProcessExplicitAppUserModelID 函式 (shobjidl_core.h)

指定可識別任務列目前進程的唯一應用程式定義應用程式使用者模型標識碼 (AppUserModelID) 。 此標識碼可讓應用程式將其相關聯的進程和視窗分組在單一任務欄按鈕下。

語法

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

參數

[in] AppID

類型: PCWSTR

要指派給目前進程的 AppUserModelID 指標。

傳回值

類型: HRESULT

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

備註

這個方法必須在應用程式的初始啟動例程期間呼叫,應用程式才會呈現任何UI,或對其 Jump 清單 進行任何操作。 這包括對 SHAddToRecentDocs 的任何呼叫。

規格需求

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

另請參閱

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

GetCurrentProcessExplicitAppUserModelID

任務列延伸模組