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.

Routine Required header Compatibility



Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For more compatibility information, see Compatibility in the Introduction.

See the example for _getdrive.