_chdrive

2015-06-09

Ä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.