Funzione GetFileType (fileapi.h)

Recupera il tipo di file del file specificato.

Sintassi

DWORD GetFileType(
  [in] HANDLE hFile
);

Parametri

[in] hFile

Handle per il file.

Valore restituito

La funzione restituisce uno dei valori seguenti.

Codice/valore restituito Descrizione
FILE_TYPE_CHAR
0x0002
Il file specificato è un file di caratteri, in genere un dispositivo LPT o una console.
FILE_TYPE_DISK
0x0001
Il file specificato è un file su disco.
FILE_TYPE_PIPE
0x0003
Il file specificato è un socket, una named pipe o una pipe anonima.
FILE_TYPE_REMOTE
0x8000
Non utilizzato.
FILE_TYPE_UNKNOWN
0x0000
Il tipo del file specificato è sconosciuto oppure la funzione non è riuscita.
 

È possibile distinguere tra una restituzione "valida" di FILE_TYPE_UNKNOWN e la relativa restituzione a causa di un errore di chiamata (ad esempio, passando un handle non valido a GetFileType) chiamando GetLastError.

Se la funzione funziona correttamente e FILE_TYPE_UNKNOWN è stata restituita, una chiamata a GetLastError restituirà NO_ERROR.

Se la funzione ha restituito FILE_TYPE_UNKNOWN a causa di un errore durante la chiamata a GetFileType, GetLastError restituirà il codice di errore.

Commenti

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0
Failover trasparente SMB 3.0 (TFO)
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)
File system del volume condiviso cluster (CsvFS)
Resilient File System (ReFS)

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione fileapi.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Funzioni di gestione file

GetFileSize

GetFileTime