_chdrive

變更目前工作磁碟機。

重要

這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 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 範例。

另請參閱

目錄控制項
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem