_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 en aplicaciones de la Plataforma universal de Windows.

Sintaxis

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, el controlador de parámetros no válidos se invoca como se describe en Validación de parámetros. Si la ejecución puede continuar, la _chdrive función devuelve -1, errno se establece EACCESen y _doserrno se establece en ERROR_INVALID_DRIVE.

La _chdrive función no es segura para subprocesos porque depende de la SetCurrentDirectory función, que 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, vea SetCurrentDirectory.

La _chdrive función solo cambia la unidad de trabajo actual; _chdir cambia el directorio de trabajo actual.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
_chdrive	<direct.h>

Para obtener más información, consulte Compatibilidad.

Ejemplo

Vea el ejemplo de _getdrive.

Consulte también

Control de directorio
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem