Metode IShellLibrary::GetFolders (shobjidl_core.h)

Artikel
03/15/2023

Mendapatkan sekumpulan folder anak yang terkandung dalam pustaka.

Sintaks

HRESULT GetFolders(
  [in]  LIBRARYFOLDERFILTER lff,
  [in]  REFIID              riid,
  [out] void                **ppv
);

Parameter

[in] lff

Jenis: LIBRARYFOLDERFILTER

Salah satu nilai LIBRARYFOLDERFILTER berikut yang menentukan folder yang akan didapatkan. Bendera ini tidak dapat digabungkan.

LFF_FORCEFILESYSTEM (1)

Hanya dapatkan folder sistem file. Folder sistem file adalah folder yang memiliki set atribut SFGAO_FILESYSTEM .

LFF_STORAGEITEMS (2)

Dapatkan semua folder yang dapat terikat ke objek IStorage . Folder ini adalah folder yang memiliki set atribut SFGAO_STORAGE atau SFGAO_FILESYSTEM .

LFF_ALLITEMS (3)

Dapatkan semua folder di pustaka.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka untuk masuk ke ppv. Nilai ini biasanya IID_IShellItemArray, tetapi juga dapat IID_IObjectCollection, IID_IObjectArray, atau IID antarmuka lain yang diimplementasikan oleh CShellItemArray.

[out] ppv

Jenis: void**

Penunjuk ke antarmuka yang diminta dalam riid. Jika panggilan ini gagal, nilai ini adalah NULL.

Nilai kembali

Jenis: HRESULT

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Panggilan berhasil dan folder yang ditentukan dikembalikan dalam ppv.
S_FALSE	Panggilan berhasil tetapi tidak semua folder yang ditentukan dikembalikan dalam ppv.
E_	Metode ini dapat mengembalikan nilai kesalahan lainnya.

Keterangan

Metode ini mendapatkan daftar folder yang diurutkan. Secara default, metode ini hanya mengembalikan lokasi penyimpanan.

Untuk hasil terbaik, gunakan makro IID_PPV_ARGS , yang ditentukan dalam Objbase.h, untuk parameter riid dan ppv . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang diacu oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian.

Persyaratan

Persyaratan	Nilai
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)