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 |
|---|---|
|
Il file specificato è un file di caratteri, in genere un dispositivo LPT o una console. |
|
Il file specificato è un file su disco. |
|
Il file specificato è un socket, una named pipe o una pipe anonima. |
|
Non utilizzato. |
|
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 | Sì |
| Failover trasparente SMB 3.0 (TFO) | Sì |
| SMB 3.0 con condivisioni file di scalabilità orizzontale (SO) | Sì |
| File system del volume condiviso cluster (CsvFS) | Sì |
| Resilient File System (ReFS) | Sì |
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 |