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