GetDriveTypeA, fonction (fileapi.h)

  • Article

Détermine si un lecteur de disque est un lecteur de disque amovible, fixe, un CD-ROM, un disque RAM ou un lecteur réseau.

Pour déterminer si un lecteur est un lecteur de type USB, appelez SetupDiGetDeviceRegistryProperty et spécifiez la propriété SPDRP_REMOVAL_POLICY .

Syntaxe

UINT GetDriveTypeA(
  [in, optional] LPCSTR lpRootPathName
);

Paramètres

[in, optional] lpRootPathName

Répertoire racine du lecteur.

Une barre oblique inverse de fin est requise. Si ce paramètre a la valeur NULL, la fonction utilise la racine du répertoire actif.

Valeur retournée

La valeur de retour spécifie le type de lecteur, qui peut être l’une des valeurs suivantes.

Code/valeur de retour Description
DRIVE_UNKNOWN
0
 Impossible de déterminer le type de lecteur.
DRIVE_NO_ROOT_DIR
1
 Le chemin d’accès racine n’est pas valide ; par exemple, aucun volume n’est monté au niveau du chemin spécifié.
DRIVE_REMOVABLE
2
 Le lecteur a un média amovible ; par exemple, une lecteur de disquette, une clé usb ou un lecteur de carte flash.
DRIVE_FIXED
3
 Le lecteur a un média fixe ; par exemple, un disque dur ou un lecteur flash.
DRIVE_REMOTE
4
 Le lecteur est un lecteur distant (réseau).
DRIVE_CDROM
5
 Le lecteur est un lecteur de CD-ROM.
DRIVE_RAMDISK
6
 Le lecteur est un disque RAM.

Notes

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 Non
Basculement transparent SMB 3.0 (TFO) Non
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) Non
Système de fichiers du volume partagé de cluster (CsvFS) Oui
Système de fichiers résilient (ReFS) Oui
 

SMB ne prend pas en charge les fonctions de gestion des volumes.

Notes

L’en-tête fileapi.h définit GetDriveType en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications

   
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

GetDiskFreeSpace

Fonctions de gestion des volumes