`_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 的示例。