_chdrive

更改当前工作驱动器。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。 有关详细信息,请参阅通用 Windows 平台应用中不支持的 CRT 函数

语法

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,必须提供自己的线程同步。 有关详细信息,请参阅 SetCurrentDirectory

_chdrive 函数仅更改当前工作驱动器;_chdir 更改当前工作目录。

默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态

要求

例程 必需的标头
_chdrive <direct.h>

有关详细信息,请参阅兼容性

示例

请参阅 _getdrive 的示例。

另请参阅

目录控制
%>
%>
%>
_getdrive
%>
%>
%>