_chdrive
Ändert das aktuelle Laufwerk.
Wichtig
Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).
Syntax
int _chdrive(
int drive
);
Parameter
drive
Eine ganze Zahl von 1 bis 26, die das aktuelle Laufwerk angibt (1=A, 2=B usw.).
Rückgabewert
Null (0), wenn das aktuelle Laufwerk erfolgreich geändert wurde; andernfalls – 1.
Hinweise
Wenn drive sich der Bereich zwischen 1 und 26 nicht befindet, wird der Handler für ungültige Parameter aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, gibt die _chdrive Funktion -1 zurück, errno ist auf EACCES, und _doserrno sie wird auf ERROR_INVALID_DRIVE.
Die _chdrive Funktion ist nicht threadsicher, da sie von der SetCurrentDirectory Funktion abhängt, die selbst nicht threadsicher ist. Um in einer Multithreadanwendung sicher zu verwenden _chdrive , müssen Sie eine eigene Threadsynchronisierung bereitstellen. Weitere Informationen finden Sie unter SetCurrentDirectory.
Die _chdrive Funktion ändert nur das aktuelle Arbeitslaufwerk; _chdir ändert das aktuelle Arbeitsverzeichnis.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Anforderungen
| Routine | Erforderlicher Header |
|---|---|
_chdrive |
<direct.h> |
Weitere Informationen finden Sie unter Kompatibilität.
Beispiel
Ein Beispiel hierfür finden Sie unter _getdrive.
Siehe auch
Verzeichnissteuerelement
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem