GetFileType, fonction (fileapi.h)
Récupère le type de fichier du fichier spécifié.
Syntaxe
DWORD GetFileType(
[in] HANDLE hFile
);
Paramètres
[in] hFile
Descripteur du fichier.
Valeur retournée
La fonction retourne l’une des valeurs suivantes.
| Code/valeur de retour | Description |
|---|---|
|
Le fichier spécifié est un fichier de caractères, généralement un appareil LPT ou une console. |
|
Le fichier spécifié est un fichier disque. |
|
Le fichier spécifié est un socket, un canal nommé ou un canal anonyme. |
|
Inutilisé. |
|
Le type du fichier spécifié est inconnu ou la fonction a échoué. |
Vous pouvez faire la distinction entre un retour « valide » de FILE_TYPE_UNKNOWN et son retour en raison d’une erreur d’appel (par exemple, en passant un handle non valide à GetFileType) en appelant GetLastError.
Si la fonction a fonctionné correctement et que FILE_TYPE_UNKNOWN a été retourné, un appel à GetLastError retourne NO_ERROR.
Si la fonction a retourné FILE_TYPE_UNKNOWN en raison d’une erreur lors de l’appel de GetFileType, GetLastError retourne le code d’erreur.
Remarques
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole Server Message Block (SMB) 3.0 | Oui |
| Basculement transparent SMB 3.0 (TFO) | Oui |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Oui |
| Système de fichiers du volume partagé de cluster (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | fileapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |