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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour