Metode IColumnProvider::GetItemData (shlobj.h)

Artikel
03/02/2024

Meminta data kolom untuk file tertentu.

Sintaks

HRESULT GetItemData(
  [in]  LPCSHCOLUMNID   pscid,
  [in]  LPCSHCOLUMNDATA pscd,
  [out] VARIANT         *pvarData
);

Parameter

[in] pscid

Jenis: LPCSHCOLUMNID

Struktur SHCOLUMNID yang mengidentifikasi kolom.

[in] pscd

Jenis: LPCSHCOLUMNDATA

Struktur SHCOLUMNDATA yang menentukan file.

[out] pvarData

Jenis: VARIAN*

Penunjuk ke VARIAN dengan data untuk file yang ditentukan oleh pscd yang termasuk dalam kolom yang ditentukan oleh pscid. Atur nilai ini jika file adalah anggota kelas yang didukung oleh penyedia kolom.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika data file dikembalikan, S_FALSE jika file tidak didukung oleh penyedia kolom dan tidak ada data yang dikembalikan, atau nilai kesalahan COM sebaliknya.

Keterangan

Metode ini dipanggil untuk mengambil data untuk file yang akan ditampilkan di kolom yang ditentukan. Ini harus aman utas.

Metode ini dipanggil untuk setiap file yang ditampilkan Windows Explorer, meskipun banyak dari mereka tidak akan didukung oleh penyedia kolom tertentu. Untuk meningkatkan performa, pertama-tama periksa anggota pwszExt dari struktur yang ditunjukkan oleh pscd untuk melihat apakah ia memiliki ekstensi nama file yang didukung oleh penyedia kolom. Jika tidak, hindari pemrosesan yang tidak perlu dengan segera mengembalikan S_FALSE.

Persyaratan

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

Bagikan melalui