IApplicationDocumentLists::SetAppID メソッド (shobjidl_core.h)

  • [アーティクル]

宛先リストを取得するアプリケーションの一意のアプリケーション ユーザー モデル ID (AppUserModelID) を指定します。 このメソッドは省略可能です。

構文

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

パラメーター

[in] pszAppID

種類: LPCWSTR

タスク バー ボタン表現がジャンプ リストを受け取るプロセスの AppUserModelID へのポインター。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

アプリケーションに明示的な AppUserModelID がある場合は、 GetList を呼び出す前にこのメソッドを呼び出す必要があります。

AppUserModelID がオブジェクトの SetAppID メソッドを使用して指定された後、AppUserModelID は、 SetAppID の別の呼び出しによって上書きされないように、そのオブジェクトの有効期間にわたってオブジェクトに保存されます。

一部のアプリケーションでは、明示的な AppUserModelID を宣言せず、このメソッドを呼び出さないでください。 その場合、アプリケーションの ID は、 IApplicationDocumentLists::GetList が呼び出されたときに推測されます。 ただし、これらの計算を回避するにはパフォーマンス上の利点があるため、カスタムジャンプリストを提供するアプリケーションでは 、明示的な AppUserModelID を使用することをお勧めします。

要件

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

関連項目

アプリケーション ユーザー モデル ID (AppUserModelIDs)

IApplicationDocumentLists

タスク バー拡張機能