_chdrive

現在の作業ドライブを変更します。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

int _chdrive(
   int drive
);

パラメーター

drive
現在の作業ドライブを指定する 1 ～ 26 の整数 (1 = A、2 = B など)。

戻り値

現在の作業ドライブが正常に変更された場合はゼロ (0)、それ以外の場合は -1。

解説

1 から 26 の範囲にない場合driveは、「パラメーターの検証」の説明に従って無効なパラメーター ハンドラーが呼び出されます。 実行を続行できる場合、_chdrive関数は -1 を返し_doserrnoERROR_INVALID_DRIVE、 errnoEACCES.

この関数は _chdrive 、スレッド セーフではない関数に依存 SetCurrentDirectory するため、スレッド セーフではありません。 マルチスレッド アプリケーションで安全に使用 _chdrive するには、独自のスレッド同期を指定する必要があります。 詳細については、SetCurrentDirectoryを参照してください。

この関数は _chdrive 、現在の作業ドライブのみを変更し、 _chdir 現在の作業ディレクトリを変更します。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

ルーチンによって返される値	必須ヘッダー
_chdrive	<direct.h>

詳細については、「互換性」をご覧ください。

例

_getdrive の例を参照してください。

関連項目

ディレクトリ コントロール
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem