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

ユーザーが既存のジャンプ リストから削除した移動先の現在のリストを取得します。このカスタムジャンプ リストは置き換えられます。

構文

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

パラメーター

[in] riid

種類: REFIID

ppv を介して取得するインターフェイスの IID への参照 (通常はIID_IObjectArray。

[out] ppv

型: void**

このメソッドが戻るとき、 には 、riid で要求されたインターフェイス ポインターが含まれます。 これは通常、 IObjectArray です。これは、削除された宛先のリスト内の項目を表す IShellItem オブジェクトまたは IShellLink オブジェクトのコレクションを表します。

戻り値

種類: HRESULT

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

注釈

項目は、ユーザー アクションを使用してジャンプ リスト UI から削除できます。 その後、アイテムは削除済みとしてマークされ、表示されなくなります。 アプリケーションは、このメソッドを使用して、ユーザーが削除した項目を通知して、カスタム リストに表示しないようにすることができます。 たとえば、アプリケーションの起動時に、そのアプリケーションが ICustomDestinationList::BeginList を使用して新しいリストを生成しない場合は、このメソッドを呼び出す必要があります。

ユーザーがその宛先を削除することを選択したときに、アプリケーションで宛先追跡データをクリアすることを強くお勧めします。 ユーザーが将来、その宛先に再度アクセスした場合は、ジャンプ リストに再び追加され、データを再度蓄積できます。 ICustomDestinationList::BeginList が呼び出されると、このメソッドによって取得されたのと同じ削除された宛先リストが取得されます。 その場合、アプリケーションは削除された項目を直ちに再挿入しようとしないでください。または AppendCategory の呼び出しが失敗します。 これにより、アプリケーションがアイテムを削除するユーザーの意図を尊重できます。

アプリケーションに明示的なアプリケーション ユーザー モデル ID (AppUserModelID) がある場合は、このメソッドを呼び出す前に SetAppID を 呼び出す必要があります。

アプリケーションが GetRemovedDestinations を 呼び出し、新しいカスタムジャンプ リストが作成されるよりも早くジャンプ リストに復元される可能性が高いアイテムをリスト上で見つけた場合でも、アプリケーションはジャンプ リストをそのアイテムなしで書き込み、ユーザーが再びアクセスした後にのみリストに再追加する必要があります。

アプリケーションは、 最近 使ったカテゴリまたは よく知られているカテゴリ をカスタムジャンプリストに追加できます。 そのカテゴリ内のアイテムは、カスタム カテゴリに表示されていない場合でも、削除されたアイテムの一覧に含まれる可能性があります。 その場合でも、保存されている場合は、そのアイテムの使用状況データをアプリケーションでクリアする必要があります。

GetRemovedDestinations を呼び出しても、削除された宛先データはクリアされません。 このデータは、次のリスト生成のために BeginList によって必要になります。 削除された宛先データは不要になり、 BeginList によってリスト生成セッションが開始され、 AppendCategory の呼び出しが失敗せず、 CommitList の呼び出しによって完了した後にクリアされます。

要件

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

こちらもご覧ください

ICustomDestinationList

ICustomDestinationList::BeginList

タスク バー拡張機能