This documentation is archived and is not being maintained.


Changes the current working drive.

int _chdrive( 
   int drive 


Number of the new working drive.

_chdrive returns a value of 0 if the working drive is successfully changed. A return value of –1 indicates an error.

The _chdrive function changes the current working drive to the drive specified by drive. The drive parameter uses an integer to specify the new working drive (1=A, 2=B, and so forth). This function changes only the working drive; _chdir changes the working directory.

If drive does not specify a valid drive, the invalid parameter handler is invoked, as described in Parameter Validation. If execution is allowed to continue, the function returns -1 and errno is set to EACCES, and _doserrno is set to ERROR_INVALID_DRIVE.


Required header



For more compatibility information, see Compatibility in the Introduction.

See the example for _getdrive.