_chdrive

Статья
04/10/2013

Изменяет текущий рабочий диск.

Важно
Этот API нельзя использовать в приложениях, запускаемых в среде выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /ZW.

int _chdrive( 
   int drive 
);

Параметры

drive
Целое число от 1 до 26, определяющее текущий рабочий диск (1=A, 2=B и т д).

Возвращаемое значение

Ноль (0), если текущий рабочий диск был успешно изменен; в противном случае — значение -1.

Заметки

Если drive не находится в диапазоне от 1 до 26, то обработчик недопустимого параметра вызывается как описано в разделе Проверка параметров.Если среда выполнения может продолжить, функция _chdrive возвращает -1, параметр errno имеет значение EACCES и параметр _doserrno имеет значение ERROR_INVALID_DRIVE.

Функция _chdrive не потокобезопасна, поскольку она зависит от функцию SetCurrentDirectory, которая сама не потокобезопасна.Для использования _chdrive безопасного в многопоточном приложении необходимо предоставить собственную синхронизацию потока.Дополнительные сведения см. на и Библиотека MSDN затем выполняет поиск объекта SetCurrentDirectory.

Изменения функции _chdrive только текущий рабочий диск; _chdir изменяет текущую рабочую папку.