_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 unter CRT-Funktionen nicht mit /ZW unterstützt.
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 nicht im Bereich von 1 bis 26 liegt, wird der Handler für ungültige Parameter aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt die _chdrive-Funktion – 1 zurück, errno wird auf EACCES gesetzt und _doserrno auf ERROR_INVALID_DRIVE.
Die _chdrive-Funktion ist nicht threadsicher, da sie von der SetCurrentDirectory-Funktion abhängt, die selbst nicht threadsicher ist. Um _chdrive sicher in einer Multithreadanwendung zu verwenden, müssen Sie eine eigene Threadsynchronisierung bereitstellen. Weitere Informationen finden Sie in der MSDN Library. Suchen Sie dort nach SetCurrentDirectory.
Die _chdrive-Funktion ändert nur das aktuelle Laufwerk; _chdir ändert das aktuelle Arbeitsverzeichnis.
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_chdrive |
<direct.h> |
Weitere Informationen finden Sie unter Kompatibilität.
Beispiel
Ein Beispiel hierfür finden Sie unter _getdrive.
.NET Framework-Entsprechung
System::Environment::CurrentDirectory