_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