_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 の例を参照してください。

関連項目

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