GetDriveTypeA, fonction (fileapi.h)
Détermine si un lecteur de disque est amovible, fixe, CD-ROM, disque RAM ou 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 est null, la fonction utilise la racine du répertoire actif.
Valeur de retour
La valeur de retour spécifie le type de lecteur, qui peut être l’une des valeurs suivantes.
| Retourner le code/la valeur | 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é sur le chemin spécifié. |
|
Le lecteur a un support amovible ; par exemple, un lecteur de floppy, un lecteur de pouce 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 CD-ROM. |
|
Le lecteur est un disque RAM. |
Remarques
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Supporté |
|---|---|
| Protocole SMB (Server Message Block) 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 |
| Cluster Shared Volume File System (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
SMB ne prend pas en charge les fonctions de gestion des volumes.
Note
L’en-tête fileapi.h définit GetDriveType comme 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | fileapi.h (include Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |