_chdrive
Change le lecteur de travail 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 dans les applications de la plateforme Windows universelle.
Syntaxe
int _chdrive(
int drive
);
Paramètres
drive
Entier compris entre 1 et 26 qui spécifie le lecteur de travail actif (1=A, 2=B et ainsi de suite).
Valeur retournée
Zéro (0) si le lecteur de travail actif a été correctement changé ; Sinon, -1.
Notes
Si drive ce n’est pas dans la plage comprise entre 1 et 26, le gestionnaire de paramètres non valides est appelé comme décrit dans la validation des paramètres. Si l’exécution est autorisée à continuer, la _chdrive fonction retourne -1, errno est définie EACCESsur , et _doserrno est définie sur ERROR_INVALID_DRIVE.
La _chdrive fonction n’est pas thread-safe, car elle dépend de la SetCurrentDirectory fonction, qui n’est pas thread-safe. Pour utiliser _chdrive en toute sécurité dans une application multithread, vous devez fournir votre propre synchronisation de threads. Pour plus d’informations, consultez SetCurrentDirectory.
La _chdrive fonction modifie uniquement le lecteur de travail actuel ; _chdir modifie le répertoire de travail actuel.
Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.
Spécifications
| Routine | En-tête requis |
|---|---|
_chdrive |
<direct.h> |
Pour plus d'informations, voir Compatibilité.
Exemple
Consultez l’exemple pour _getdrive.
Voir aussi
Contrôle d’annuaire
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem