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
FILE_TYPE_CHAR 0x0002	Le fichier spécifié est un fichier de caractères, généralement un appareil LPT ou une console.
FILE_TYPE_DISK 0x0001	Le fichier spécifié est un fichier disque.
FILE_TYPE_PIPE 0x0003	Le fichier spécifié est un socket, un canal nommé ou un canal anonyme.
FILE_TYPE_REMOTE 0x8000	Inutilisé.
FILE_TYPE_UNKNOWN 0x0000	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

Fonctions de gestion des fichiers

GetFileSize

GetFileTime