_chdrive

Altera a unidade de trabalho atual.

Importante

Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

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).

Retornar valor

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á chamado conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, a _chdrive função retornará -1, será definida como EACCES, errno 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 multi-threaded, você deve fornecer sua própria sincronização de thread. 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, consulte Estado global na CRT.

Requisitos

Rotina	Cabeçalho necessário
_chdrive	<direct.h>

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