IApplicationDestinations::RemoveDestination メソッド (shobjidl_core.h)

ジャンプ リストの Recent カテゴリと Frequent カテゴリから 1 つの宛先を削除します。

構文

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

パラメーター

[in] punk

種類: IUnknown*

削除する宛先を表す IShellItem または IShellLink へのポインター。

戻り値

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は標準の COM エラー値を返します。 punk が指すオブジェクトが IShellItem または IShellLink でない場合、メソッドは E_INVALIDARGを返します。

注釈

宛先は、[ 最近] カテゴリと [ 頻度 ] カテゴリの両方に表示できます。 その場合、このメソッドは両方のカテゴリから宛先を削除します。

アイテムがユーザーによってリストにピン留めされている場合、アイテムは削除されませんが、その使用状況データはクリアされます。

アプリケーションは、パンクが指す項目が現在リストに含まれているかどうかを知らなくても、RemoveDestination を呼び出すことができます。 アイテムに既存のデータがない場合 (その場合は [ 最近] または [ 頻繁 ] リストに含まれていない場合)、このメソッドは何も行わないので、S_OKを返します。

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

要件

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

こちらもご覧ください

IApplicationDestinations

IApplicationDestinations::RemoveAllDestinations

IApplicationDestinations::SetAppID

タスク バーの拡張機能