IShellDetails::GetDetailsOf method (shlobj_core.h)

Artikel
03/02/2024

Mendapatkan informasi terperinci tentang item dalam folder Shell.

Sintaks

HRESULT GetDetailsOf(
  [in, optional] PCUITEMID_CHILD pidl,
                 UINT            iColumn,
  [out]          SHELLDETAILS    *pDetails
);

Parameter

[in, optional] pidl

Jenis: PCUITEMID_CHILD

PIDL item yang Anda minta informasinya. Jika parameter ini diatur ke NULL, judul bidang informasi yang ditentukan oleh iColumn akan dikembalikan dalam struktur SHELLDETAILS yang diacu oleh pDetails.

iColumn

Jenis: UINT

Indeks berbasis nol dari bidang informasi yang diinginkan. Ini identik dengan nomor kolom informasi seperti yang ditampilkan dalam tampilan Detail Windows Explorer.

[out] pDetails

Jenis: SHELLDETAILS*

Penunjuk ke struktur SHELLDETAILS dengan informasi detail.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil. Mengembalikan E_FAIL jika iColumn melebihi jumlah kolom yang didukung oleh folder. Jika tidak, mengembalikan kode kesalahan COM standar.

Keterangan

Metode ini telah digantikan oleh metode IShellFolder2 untuk Shell versi 5.0 dan yang lebih baru.

Metode IShellDetails::GetDetailsOf menyediakan akses ke informasi yang ditampilkan dalam tampilan Detail Windows Explorer dari folder Shell. Nomor kolom, judul kolom, dan informasi item yang Anda lihat dalam tampilan Detail identik dengan yang dikembalikan oleh IShellDetails::GetDetailsOf.

Bidang informasi yang tersedia dan nomor kolomnya bervariasi tergantung pada folder tertentu. Untuk menghitung bidang yang tersedia, panggil IShellDetails::GetDetailsOf dengan pidl diatur ke NULL untuk meningkatkan nilai iColumn. Pendekatan ini memberi Anda judul yang terkait dengan setiap indeks kolom. Ketika iColumn melebihi jumlah kolom yang didukung oleh folder, IShellDetails::GetDetailsOf akan mengembalikan E_FAIL. Perlu diingat bahwa judul ini dapat dilokalkan, dan mungkin tidak sama untuk semua lokal.

Folder sistem file memiliki sekumpulan bidang informasi standar yang besar. Empat bidang pertama adalah standar untuk semua folder sistem file.

Indeks Kolom	Judul Kolom
0	Nama
1	Ukuran
2	Jenis
3	Tanggal Diubah

Folder sistem file mungkin mendukung sejumlah bidang tambahan. Namun, mereka tidak diharuskan untuk melakukannya dan indeks kolom yang ditetapkan ke bidang ini dapat bervariasi.

Setiap folder virtual memiliki kumpulan bidang informasi uniknya sendiri. Biasanya, nama tampilan item berada di kolom nol, tetapi urutan dan konten bidang yang tersedia bergantung pada implementasi objek folder tertentu.

Catatan untuk Pelaksana

Objek folder harus mengimplementasikan IShellFolder2 alih-alih antarmuka ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui