_chdrive
Modifie le lecteur actif.
Important
Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.
int _chdrive(
int drive
);
Paramètres
- drive
Un entier compris entre 1 et 26 qui spécifie le lecteur de travail actif (1=A, 2=B, etc.).
Valeur de retour
Zéro (0) si le lecteur de travail actuel a été modifié avec succès ; sinon, -1.
Notes
Si drive n'est pas dans la plage de 1 à 26, le gestionnaire de paramètre non valide est appelé comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, la fonction _chdrive retourne -1, errno est défini à EACCES et _doserrno est défini à ERROR_INVALID_DRIVE.
La fonction _chdrive n'est pas thread-safe car elle dépend de la fonction SetCurrentDirectory, qui est elle-même non thread-safe. Pour utiliser _chdrive sans risque dans une application multithread, vous devez fournir votre propre synchronisation de threads. Pour plus d'informations, accédez à MSDN Library puis recherchez SetCurrentDirectory.
Les modifications de fonction _chdrive modifient uniquement le lecteur de travail actuel; _chdir modifie le répertoire de travail actuel.
Configuration requise
Routine |
En-tête requis |
|---|---|
_chdrive |
<direct.h> |
Pour plus d'informations, consultez Compatibilité.
Exemple
Consultez l'exemple pour _getdrive.
Équivalent .NET Framework
System::Environment::CurrentDirectory