_chdrive

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

Важно!

Этот 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 изменяет текущую рабочую папку.

Требования

Подпрограмма

Обязательный заголовок

_chdrive

<direct.h>

Для получения дополнительной информации см. Совместимость.

Пример

См. пример в разделе _getdrive.

Эквивалент в .NET Framework

System::Environment::CurrentDirectory

См. также

Ссылки

Управление каталогами

_chdir, _wchdir

_fullpath, _wfullpath

_getcwd, _wgetcwd

_getdrive

_mkdir, _wmkdir

_rmdir, _wrmdir

system, _wsystem