SetCurrentProcessExplicitAppUserModelID 関数 (shobjidl_core.h)

タスクバーへの現在のプロセスを識別する一意のアプリケーション定義アプリケーションユーザーモデル ID (AppUserModelID) を指定します。この識別子を使用すると、アプリケーションは関連付けられているプロセスとウィンドウを 1 つのタスクバーボタンの下にグループ化できます。

構文

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

[in] AppID

種類: PCWSTR

現在のプロセスに割り当てる AppUserModelID へのポインター。

種類: HRESULT

この関数が成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

このメソッドは、アプリケーションが UI を表示したり、ジャンプ Listsを操作したりする前に、アプリケーションの初期スタートアップルーチン中に呼び出す必要があります。これには、SHAddToRecentDocs の呼び出しが含まれます。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 6.1 以降)