Partage via


_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