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 以降) |