Fungsi GetFileType (fileapi.h)

  • Artikel

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