_chdrive
Cambia la unidad de trabajo actual.
Importante
Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones de CRT no admitidas con /ZW.
int _chdrive(
int drive
);
Parámetros
- drive
Entero de 1 a 26 que especifica la unidad de trabajo actual (1=A, 2=B, etc.).
Valor devuelto
Cero (0) si la unidad de trabajo actual se ha cambiado correctamente; de lo contrario, -1.
Comentarios
Si drive no está en el intervalo comprendido entre 1 y 26, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, la función _chdrive devuelve -1, errno se establece en EACCES y _doserrno se establece en ERROR_INVALID_DRIVE.
La función _chdrive no es segura para subprocesos porque depende de la función SetCurrentDirectory, que a su vez no es segura para subprocesos. Para usar _chdrive de forma segura en una aplicación multiproceso, debe proporcionar su propia sincronización de subprocesos. Para obtener más información, vaya a MSDN Library y busque SetCurrentDirectory.
La función _chdrive solo cambia la unidad de trabajo actual; _chdir cambia el directorio de trabajo actual.
Requisitos
Rutina |
Encabezado necesario |
|---|---|
_chdrive |
<direct.h> |
Para obtener más información, vea Compatibilidad.
Ejemplo
Consulte el ejemplo de _getdrive.
Equivalente en .NET Framework
System::Environment::CurrentDirectory