struktur WIN32_FIND_DATAA (minwinbase.h)

Artikel
11/08/2024

Berisi informasi tentang file yang ditemukan oleh fungsi FindFirstFile, FindFirstFileEx, atau FindNextFile.

Sintaksis

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 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 ditulis ke, dipotong, 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 berurutan 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 pemisahan ulang.

Jika tidak, nilai ini tidak ditentukan dan tidak boleh digunakan.

Untuk informasi selengkapnya, lihat Pilah Ulang Tag Titik.

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

Dicadangkan untuk digunakan di masa mendatang.

cFileName[MAX_PATH]

Nama file.

cAlternateFileName[14]

Nama alternatif untuk file.

Nama ini dalam format nama file 8.3 klasik.

Komentar

Jika file memiliki nama file yang panjang, nama lengkap muncul di anggota cFileName, dan versi nama yang dipotong 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 buat 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 File Times.

Nota

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

Syarat	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)