_chdrive
現在の作業ドライブを変更します。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
int _chdrive(
int drive
);
パラメーター
drive
現在の作業ドライブを指定する 1 ~ 26 の整数 (1 = A、2 = B など)。
戻り値
現在の作業ドライブが正常に変更された場合はゼロ (0)、それ以外の場合は -1。
解説
1 から 26 の範囲にない場合drive
は、「パラメーターの検証」の説明に従って無効なパラメーター ハンドラーが呼び出されます。 実行を続行できる場合、_chdrive
関数は -1 を返し_doserrno
ERROR_INVALID_DRIVE
、 errno
EACCES
.
この関数は _chdrive
、スレッド セーフではない関数に依存 SetCurrentDirectory
するため、スレッド セーフではありません。 マルチスレッド アプリケーションで安全に使用 _chdrive
するには、独自のスレッド同期を指定する必要があります。 詳細については、SetCurrentDirectory
を参照してください。
この関数は _chdrive
、現在の作業ドライブのみを変更し、 _chdir
現在の作業ディレクトリを変更します。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
必要条件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
_chdrive |
<direct.h> |
詳細については、「互換性」をご覧ください。
例
_getdrive
の例を参照してください。
関連項目
ディレクトリ コントロール
_chdir
, _wchdir
_fullpath
, _wfullpath
_getcwd
, _wgetcwd
_getdrive
_mkdir
, _wmkdir
_rmdir
, _wrmdir
system
, _wsystem
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示