更改当前工作驱动器。
重要
此 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 的示例。