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