IApplicationDocumentLists::GetList メソッド (shobjidl_core.h)

ジャンプ リストの [最近 ] または [ 頻繁 ] カテゴリに一覧表示されている変換先のコレクションを表すオブジェクトを取得します。

構文

HRESULT GetList(
  [in]  APPDOCLISTTYPE listtype,
  [in]  UINT           cItemsDesired,
  [in]  REFIID         riid,
  [out] void           **ppv
);

パラメーター

[in] listtype

種類: APPDOCLISTTYPE

宛先のリストを取得するカテゴリを指定する次のいずれかの値。

ADLT_RECENT (0x0)

0x0。 最近アクセスしたアイテムを一覧表示する [ 最近 ] カテゴリ。

ADLT_FREQUENT (0x1)

0x1。 [頻度] カテゴリ。アクセス回数が最も多いアイテムが一覧表示されます。

[in] cItemsDesired

型: UINT

listtype で指定されたリストから取得する項目の数。 完全なリストを取得するには、このパラメーターを 0 に設定します。

[in] riid

種類: REFIID

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

[out] ppv

型: void**

このメソッドが戻るとき、 には 、riid で要求されたインターフェイス ポインターが含まれます。 これは通常、リストから取得されたアイテムを表す IShellItem オブジェクトまたは IShellLink オブジェクト (または 2 つの組み合わせ) のコレクションを表す IObjectArray または IEnumObjects です。

戻り値

種類: HRESULT

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

解説

アイテムは、 最近使った リストと 頻繁 なリストの両方に表示できます。

ユーザーが 最近 使用したカテゴリまたは 頻繁 なカテゴリのアイテムをピン留めした場合、ジャンプ リストに重複しないように、アイテムは元のカテゴリに表示されなくなります。 ただし、アイテムは引き続きこのメソッドによって返されます。

要件

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

関連項目

IApplicationDocumentLists

IApplicationDocumentLists::SetAppID

タスク バー拡張機能