Fungsi GetFileSizeEx (fileapi.h)
Mengambil ukuran file yang ditentukan.
Sintaks
BOOL GetFileSizeEx(
[in] HANDLE hFile,
[out] PLARGE_INTEGER lpFileSize
);
Parameter
[in] hFile
Handel ke file. Handel harus dibuat dengan hak akses FILE_READ_ATTRIBUTES atau setara, atau pemanggil harus memiliki izin yang memadai pada direktori yang berisi file. Untuk informasi selengkapnya, lihat Keamanan File dan Hak Akses.
[out] lpFileSize
Penunjuk ke struktur LARGE_INTEGER yang menerima ukuran file, dalam byte.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Operasi yang Ditransaksikan: Jika ada transaksi yang terikat ke handel file, maka fungsi mengembalikan informasi untuk tampilan file yang terisolasi.
Aplikasi Bursa Windows: GetFileSizeEx tidak didukung. Gunakan GetFileInformationByHandleEx.
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
| Teknologi | Didukung |
|---|---|
| Protokol Server Message Block (SMB) 3.0 | Ya |
| SMB 3.0 Transparent Failover (TFO) | Ya |
| SMB 3.0 dengan Scale-out File Shares (SO) | Ya |
| Sistem File Volume Bersama Kluster (CsvFS) | Ya |
| Sistem File Tangguh (ReFS) | Ya |
Persyaratan
| Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | fileapi.h (sertakan Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |