IApplicationDocumentLists::Metode GetList (shobjidl_core.h)

Artikel
08/26/2023

Mengambil objek yang mewakili kumpulan tujuan yang tercantum dalam kategori Terbaru atau Sering dalam Daftar Lompat.

Sintaks

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

Parameter

[in] listtype

Jenis: APPDOCLISTTYPE

Salah satu nilai berikut yang menentukan dari kategori mana daftar tujuan harus diambil.

ADLT_RECENT (0x0)

0x0. Kategori Terbaru , yang mencantumkan item tersebut yang terakhir diakses.

ADLT_FREQUENT (0x1)

0x1. Kategori Sering , yang mencantumkan item yang telah diakses paling banyak kali.

[in] cItemsDesired

Jenis: UINT

Jumlah item yang akan diambil dari daftar yang ditentukan dalam listtype. Atur parameter ini ke 0 untuk mengambil daftar lengkap.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppv, biasanya IID_IObjectArray atau IID_IEnumObjects.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya merupakan IObjectArray atau IEnumObjects yang mewakili koleksi objek IShellItem atau IShellLink (atau campuran keduanya) yang mewakili item yang diambil dari daftar.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Item bisa muncul di daftar Terbaru dan Sering .

Jika pengguna menyematkan item dalam kategori Terbaru atau Sering , item tidak lagi ditampilkan dalam kategori aslinya untuk menghindari duplikasi di Daftar Lompat. Namun, item masih akan dikembalikan dengan metode ini.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 6.1 atau yang lebih baru)