Struktur SHCOLUMNDATA (shlobj.h)

Artikel
03/13/2023

Berisi informasi yang mengidentifikasi file tertentu. Ini digunakan oleh IColumnProvider::GetItemData saat meminta data untuk file tertentu.

Sintaks

typedef struct {
  ULONG dwFlags;
  DWORD dwFileAttributes;
  ULONG dwReserved;
  WCHAR *pwszExt;
  WCHAR wszFile[MAX_PATH];
} SHCOLUMNDATA, *LPSHCOLUMNDATA;

Anggota

dwFlags

Jenis: ULONG

Bendera yang digunakan untuk menentukan sifat permintaan.

SHCDF_UPDATEITEM

File yang ditentukan oleh wszFile adalah file baru atau file yang telah berubah sejak panggilan terakhir ke IColumnProvider::GetItemData. Setiap data yang di-cache harus dibersihkan dan dihitung ulang. Penangan kolom yang tidak menyimpan data cache, atau yang menampilkan data yang disimpan secara terpisah dari file, dapat mengabaikan bendera ini.

dwFileAttributes

Jenis: DWORD

Bendera atribut file. Ini akan menjadi satu atau beberapa nilai berikut.

FILE_ATTRIBUTE_ARCHIVE

File atau direktori adalah file arsip atau direktori. Aplikasi menggunakan atribut ini untuk menandai file untuk pencadangan atau penghapusan.

FILE_ATTRIBUTE_COMPRESSED

File atau direktori dikompresi. Untuk file, ini berarti bahwa semua data dalam file dikompresi. Untuk direktori, ini berarti bahwa kompresi adalah default untuk file dan subdirektori yang baru dibuat.

FILE_ATTRIBUTE_DIRECTORY

Handel mengidentifikasi direktori.

FILE_ATTRIBUTE_ENCRYPTED

File atau direktori dienkripsi. Untuk file, ini berarti bahwa semua aliran data dalam file dienkripsi. Untuk direktori, ini berarti bahwa enkripsi adalah default untuk file dan subdirektori yang baru dibuat.

FILE_ATTRIBUTE_HIDDEN

File atau direktori disembunyikan. Ini tidak termasuk dalam daftar direktori biasa.

FILE_ATTRIBUTE_NORMAL

File atau direktori tidak memiliki atribut lain yang ditetapkan. Atribut ini hanya valid jika digunakan sendiri.

FILE_ATTRIBUTE_OFFLINE

Data file tidak segera tersedia. Atribut ini menunjukkan bahwa data file telah dipindahkan secara fisik ke penyimpanan offline. Atribut ini digunakan oleh Remote Storage, perangkat lunak manajemen penyimpanan hierarkis di Windows 2000. Jika atribut ini diatur, handler kolom harus menghindari membuka file karena melakukannya akan menyebabkan file dipanggil kembali dari penyimpanan offline.

FILE_ATTRIBUTE_READONLY

File atau direktori bersifat baca-saja. Aplikasi dapat membaca file tetapi tidak dapat menulis atau menghapusnya. Dalam kasus direktori, aplikasi tidak dapat menghapusnya.

FILE_ATTRIBUTE_REPARSE_POINT

File memiliki titik pemilah ulang terkait.

FILE_ATTRIBUTE_SPARSE_FILE

File adalah file jarang.

FILE_ATTRIBUTE_SYSTEM

File atau direktori adalah bagian dari, atau digunakan secara eksklusif oleh, sistem operasi.

FILE_ATTRIBUTE_TEMPORARY

File sedang digunakan untuk penyimpanan sementara. Sistem file mencoba menyimpan semua data dalam memori untuk akses yang lebih cepat daripada membersihkan data kembali ke penyimpanan massal. File sementara harus dihapus oleh aplikasi segera setelah tidak lagi diperlukan.

dwReserved

Jenis: ULONG

Dicadangkan. Atur ke NULL.

pwszExt

Jenis: WCHAR*

Penunjuk ke string Unicode yang dihentikan null dengan ekstensi nama file.

wszFile[MAX_PATH]

Jenis: WCHAR[MAX_PATH]

String Unicode yang dihentikan null yang berisi jalur file yang sepenuhnya memenuhi syarat.

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]
Header	shlobj.h

Lihat juga

GetFileAttributes

Bagikan melalui