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

タスク バー ボタンが、このインターフェイスのメソッドを介して構築されたカスタムジャンプ リストを保持するアプリケーションの一意のアプリケーション ユーザー モデル ID (AppUserModelID) を指定します。 このメソッドは省略可能です。

構文

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

パラメーター

[in] pszAppID

種類: LPCWSTR

タスク バー表現がジャンプ リストを受け取るプロセスまたはアプリケーションの AppUserModelID へのポインター。

戻り値

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は次のようなエラー値を返します。

リターン コード 説明
E_UNEXPECTED
このメソッドは 、ICustomDestinationList::BeginList の後に呼び出されました。 リスト構築プロセスは、システムによって推論されるか、BeginList の呼び出しの前に SetAppID の呼び出しによって設定された、特定の AppUserModelID で既に実行されています。 リスト作成操作の進行中は、 CommitList または AbortList が呼び出されるまで AppUserModelID を変更できません。

注釈

アプリケーションに明示的な AppUserModelID がある場合は、ICustomDestinationList::BeginList または ICustomDestinationList::GetRemovedDestinations を呼び出す前に SetAppID を呼び出す必要があります。

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

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

要件

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

こちらもご覧ください

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

ICustomDestinationList

SetCurrentProcessExplicitAppUserModelID

タスク バーの拡張機能