IApplicationDocumentLists：：GetList 方法 (shobjidl_core.h)

擷取物件，此物件代表跳躍清單中 [ 最近 ] 或 [ 常用 ] 類別中列出的目的地集合。

語法

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

[in] listtype

類型： APPDOCLISTTYPE

下列其中一個值，指定應該從哪個類別擷取目的地清單。

0x0。 [ 最近] 類別，列出最近存取的專案。

0x1。 [常用] 類別，列出已存取次數最高的專案。

[in] cItemsDesired

類型： UINT

要從 listtype中指定的清單中擷取的專案數目。將此參數設定為 0 以擷取完整清單。

[in] riid

類型： REFIID

要透過 ppv擷取之介面 IID 的參考，通常IID_IObjectArray或IID_IEnumObjects。

[out] ppv

類型： void**

當這個方法傳回時，包含 riid中要求的介面指標。這通常是 IObjectArray 或 IEnumObjects ，代表 IShellItem 或 IShellLink 物件的集合， (或兩個) 混合，代表清單中擷取的專案。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

專案可以同時出現在 [ 最近 ] 和 [ 常用 ] 清單中。

如果使用者釘選 [ 最近 ] 或 [ 常用 ] 類別中的專案，專案就不會再顯示在其原始類別中，以避免跳躍清單重複。不過，這個方法仍會傳回專案。