現在の作業ドライブを変更します。
重要
この 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