ICustomDestinationList::GetRemovedDestinations メソッド (shobjidl_core.h)
既存のジャンプ リストからユーザーによって削除された移動先の現在のリストを取得します。このカスタムジャンプ リストは置き換えられます。
構文
HRESULT GetRemovedDestinations(
[in] REFIID riid,
[out] void **ppv
);
パラメーター
[in] riid
型: REFIID
ppvを介して取得するインターフェイスの IID への参照 (通常はIID_IObjectArray。
[out] ppv
型: void**
このメソッドから制御が戻るときに、riidで要求されたインターフェイス ポインター
戻り値
型: HRESULT
このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。
備考
項目は、ユーザー アクションを使用してジャンプ リスト UI から削除できます。 その後、アイテムは削除済みとしてマークされ、表示されなくなります。 アプリケーションでは、このメソッドを使用して、ユーザーが削除した項目を通知して、カスタム リストに表示しないようにすることができます。 たとえば、アプリケーションの起動時にこのメソッドを呼び出す必要があります。そのアプリケーションが ICustomDestinationList::BeginListを使用して新しいリスト
ユーザーがその宛先を削除することを選択した場合は、アプリケーションで宛先追跡データをクリアすることを強くお勧めします。 ユーザーが将来その宛先に再度アクセスした場合は、ジャンプ リストに再び追加され、再びデータが蓄積される可能性があります。 ICustomDestinationList::BeginList
アプリケーションに明示的なアプリケーション ユーザー モデル ID (AppUserModelID) がある場合は、このメソッドを呼び出す前 SetAppID を呼び出す必要があります。
アプリケーションが GetRemovedDestinations
アプリケーションは、カスタムジャンプリストに 最近使った または 頻繁既知のカテゴリ を追加できます。 そのカテゴリ内の項目は、カスタム カテゴリに表示されなかった場合でも、削除された項目リストに含まれている可能性があります。 その場合でも、そのアイテムの使用状況データが保存されていた場合でも、アプリケーションは消去する必要があります。
GetRemovedDestinations を
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |
ライブラリ | Shell32.lib |
DLL | Shell32.dll (バージョン 6.1 以降) |
関連項目
ICustomDestinationList::BeginList
タスク バー拡張機能 を