struktur WIN32_FIND_DATAA (minwinbase.h)
Berisi informasi tentang file yang ditemukan oleh fungsi FindFirstFile, FindFirstFileEx, atau FindNextFile .
Sintaks
typedef struct _WIN32_FIND_DATAA {
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD dwReserved0;
DWORD dwReserved1;
CHAR cFileName[MAX_PATH];
CHAR cAlternateFileName[14];
DWORD dwFileType; // Obsolete. Do not use.
DWORD dwCreatorType; // Obsolete. Do not use
WORD wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAA, *PWIN32_FIND_DATAA, *LPWIN32_FIND_DATAA;
Anggota
dwFileAttributes
Atribut file dari file.
Untuk nilai yang mungkin dan deskripsinya, lihat Konstanta Atribut File.
Atribut FILE_ATTRIBUTE_SPARSE_FILE pada file diatur jika salah satu aliran file pernah jarang.
ftCreationTime
Struktur FILETIME yang menentukan kapan file atau direktori dibuat.
Jika sistem file yang mendasar tidak mendukung waktu pembuatan, anggota ini adalah nol.
ftLastAccessTime
Struktur FILETIME .
Untuk file, struktur menentukan kapan file terakhir dibaca dari, ditulis ke, atau untuk file yang dapat dieksekusi, jalankan.
Untuk direktori, struktur menentukan kapan direktori dibuat. Jika sistem file yang mendasar tidak mendukung waktu akses terakhir, anggota ini adalah nol.
Pada sistem file FAT, tanggal yang ditentukan untuk file dan direktori sudah benar, tetapi waktu hari selalu diatur ke tengah malam.
ftLastWriteTime
Struktur FILETIME .
Untuk file, struktur menentukan kapan file terakhir kali ditulis, dipotok, atau ditimpa, misalnya, ketika WriteFile atau SetEndOfFile digunakan. Tanggal dan waktu tidak diperbarui ketika atribut file atau deskriptor keamanan diubah.
Untuk direktori, struktur menentukan kapan direktori dibuat. Jika sistem file yang mendasar tidak mendukung waktu tulis terakhir, anggota ini adalah nol.
nFileSizeHigh
Nilai DWORD urutan tinggi dari ukuran file, dalam byte.
Nilai ini nol kecuali ukuran file lebih besar dari MAXDWORD.
Ukuran file sama dengan (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow.
nFileSizeLow
Nilai DWORD berurutan rendah dari ukuran file, dalam byte.
dwReserved0
Jika anggota dwFileAttributes menyertakan atribut FILE_ATTRIBUTE_REPARSE_POINT , anggota ini menentukan tag titik pemilah ulang.
Jika tidak, nilai ini tidak ditentukan dan tidak boleh digunakan.
Untuk informasi selengkapnya, lihat Reparse Point Tags.
IO_REPARSE_TAG_CSV (0x80000009)
IO_REPARSE_TAG_DEDUP (0x80000013)
IO_REPARSE_TAG_DFS (0x8000000A)
IO_REPARSE_TAG_DFSR (0x80000012)
IO_REPARSE_TAG_HSM (0xC0000004)
IO_REPARSE_TAG_HSM2 (0x80000006)
IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)
IO_REPARSE_TAG_NFS (0x80000014)
IO_REPARSE_TAG_SIS (0x80000007)
IO_REPARSE_TAG_SYMLINK (0xA000000C)
IO_REPARSE_TAG_WIM (0x80000008)
dwReserved1
Disiapkan untuk penggunaan masa mendatang.
cFileName[MAX_PATH]
Nama file.
cAlternateFileName[14]
Nama alternatif untuk file.
Nama ini dalam format nama file 8.3 klasik.
Keterangan
Jika file memiliki nama file yang panjang, nama lengkap muncul di anggota cFileName , dan versi nama yang dipoting format 8.3 muncul di anggota cAlternateFileName . Jika tidak, cAlternateFileName kosong. Jika fungsi FindFirstFileEx dipanggil dengan nilai FindExInfoBasic dalam parameter fInfoLevelId , anggota cAlternateFileName akan selalu berisi nilai string NULL . Ini tetap berlaku untuk semua panggilan berikutnya ke fungsi FindNextFile . Sebagai metode alternatif untuk mengambil versi format 8.3 dari nama file, Anda dapat menggunakan fungsi GetShortPathName . Untuk informasi selengkapnya tentang nama file, lihat Nama File, Jalur, dan Namespace.
Tidak semua sistem file dapat merekam pembuatan dan waktu akses terakhir, dan tidak semua sistem file merekamnya dengan cara yang sama. Misalnya, pada sistem file FAT, waktu pembuatan memiliki resolusi 10 milidetik, waktu tulis memiliki resolusi 2 detik, dan waktu akses memiliki resolusi 1 hari. Sistem file NTFS menunda pembaruan ke waktu akses terakhir untuk file hingga 1 jam setelah akses terakhir. Untuk informasi selengkapnya, lihat Waktu File.
Catatan
Header minwinbase.h mendefinisikan WIN32_FIND_DATA sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Header | minwinbase.h (termasuk Windows.h) |