ICustomDestinationList::D eleteList メソッド (shobjidl_core.h)

  • [アーティクル]

指定したアプリケーションのカスタムジャンプ リストを削除します。

構文

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

パラメーター

[in] pszAppID

種類: LPCWSTR

タスク バー ボタン表現にカスタムジャンプ リストが表示されるプロセスの AppUserModelID へのポインター。 Windows 7 のベータ 版リリースでは、このメソッドは別のプロセスで実行されるアンインストーラーから呼び出されることを意図しているため、この AppUserModelID を明示的に指定する必要があります。 これは別のプロセスにあるため、システムは AppUserModelID を確実に推測できません。 この制限は、今後のリリースで削除される予定です。

戻り値

型: HRESULT

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

解説

このメソッドを呼び出す必要があるインスタンスは、次のとおりです。

  • アプリケーションがアンインストールされたとき。
  • ユーザーがアプリケーション内から履歴をクリアしたとき。
  • ユーザーがアプリケーションの [設定] ページまたは [オプション] ページで宛先の追跡を無効にした場合。
アプリケーションがカスタム変換先リストを更新している場合は、このメソッドを呼び出さないでください。 アンインストール操作中にリストを完全にクリアする場合、またはユーザーがリストをオフにするオプションがアプリケーションに用意されている場合にのみ使用されます。

カスタムジャンプリストが削除されると、最近使用したアイテムのシステム生成データから生成された標準ジャンプリストが表示されます。 このようなデータが収集されていない場合、または RemoveAllDestinations を使用して情報がクリアされている場合、ジャンプ リストには最小限のコンテンツ (ピン留めまたは固定解除、アプリケーションの新しいインスタンスの起動、ウィンドウの閉じる標準タスク) のみが含まれている可能性があります。

要件

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

関連項目

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

ICustomDestinationList

ICustomDestinationList::SetAppID

タスク バーの拡張機能