_chdrive

Altera a unidade de trabalho atual.

Sintaxe

int _chdrive(
   int drive
);

Parâmetros

drive
Um inteiro de 1 a 26 que especifica a unidade de trabalho atual (1 = A, B = 2 e assim por diante).

Valor retornado

Zero (0) se a unidade de trabalho atual tiver sido alterada com sucesso; caso contrário, -1.

Comentários

Se drive não estiver no intervalo de 1 a 26, o manipulador de parâmetro inválido será invocado conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, a _chdrive função retornará -1, errno será definida como EACCES, e _doserrno será definida como ERROR_INVALID_DRIVE.

A _chdrive função não é thread-safe porque depende da SetCurrentDirectory função, que em si não é thread-safe. Para usar _chdrive com segurança em um aplicativo multithread, você deve fornecer sua própria sincronização de threads. Para obter mais informações, consulte SetCurrentDirectory.

A _chdrive função altera apenas a unidade de trabalho atual; _chdir altera o diretório de trabalho atual.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Para obter mais informações, consulte Compatibilidade.

Exemplo

Confira o exemplo de _getdrive.

Confira também

Controle de diretório
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem