GetDriveTypeA, fonction (fileapi.h)
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 |
---|---|
|
Impossible de déterminer le type de lecteur. |
|
Le chemin d’accès racine n’est pas valide ; par exemple, aucun volume n’est monté au niveau du chemin spécifié. |
|
Le lecteur a un média amovible ; par exemple, une lecteur de disquette, une clé usb ou un lecteur de carte flash. |
|
Le lecteur a un média fixe ; par exemple, un disque dur ou un lecteur flash. |
|
Le lecteur est un lecteur distant (réseau). |
|
Le lecteur est un lecteur de CD-ROM. |
|
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 |