`_chdrive`

Статья
10/12/2023

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

Внимание

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

Синтаксис

int _chdrive(
   int drive
);

Параметры

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

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

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

Замечания

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

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

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

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Маршрут	Обязательный заголовок
`_chdrive`	<direct.h>

Дополнительные сведения см. в разделе Совместимость.

Пример

Пример см. в примере _getdrive.

См. также

Элемент управления каталогом
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem

Поделиться через