Fungsi GetFileType (fileapi.h)

Mengambil tipe file dari file yang ditentukan.

Sintaks

DWORD GetFileType(
  [in] HANDLE hFile
);

Parameter

[in] hFile

Handel ke file.

Nilai kembali

Fungsi mengembalikan salah satu nilai berikut.

Mengembalikan kode/nilai	Deskripsi
FILE_TYPE_CHAR 0x0002	File yang ditentukan adalah file karakter, biasanya perangkat LPT atau konsol.
FILE_TYPE_DISK 0x0001	File yang ditentukan adalah file disk.
FILE_TYPE_PIPE 0x0003	File yang ditentukan adalah soket, pipa bernama, atau pipa anonim.
FILE_TYPE_REMOTE 0x8000	Tidak digunakan.
FILE_TYPE_UNKNOWN 0x0000	Jenis file yang ditentukan tidak diketahui, atau fungsi gagal.

 

Anda dapat membedakan antara pengembalian FILE_TYPE_UNKNOWN "valid" dan pengembaliannya karena kesalahan panggilan (misalnya, meneruskan handel yang tidak valid ke GetFileType) dengan memanggil GetLastError.

Jika fungsi berfungsi dengan baik dan FILE_TYPE_UNKNOWN dikembalikan, panggilan ke GetLastError akan mengembalikan NO_ERROR.

Jika fungsi dikembalikan FILE_TYPE_UNKNOWN karena kesalahan dalam memanggil GetFileType, GetLastError akan mengembalikan kode kesalahan.

Keterangan

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 Berbagi File Peluasan Skala (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

Persyaratan

Persyaratan	Nilai
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

Lihat juga

Fungsi Manajemen File

GetFileSize

GetFileTime