_chdrive

Artigo
02/25/2013

Altera a unidade atual trabalhando.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

int _chdrive( int drive );

Parâmetros

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

Valor de retorno

Zero (0) se a unidade atual foi alterada trabalhando com êxito; caso contrário, -1.

Comentários

Se drive não está no intervalo de 1 a 26, o manipulador de inválido- parâmetro é invocado como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função de _chdrive retorna -1, errno é definido como EACCES, e _doserrno é definido como ERROR_INVALID_DRIVE.

A função de _chdrive não é segura porque depende da função de SetCurrentDirectory , que é própria com segmentos não seguro.Para usar com segurança _chdrive em um aplicativo com vários segmentos, você deve fornecer sua sincronização de threads.Para obter mais informações, vá Biblioteca MSDN para e então pesquisar por SetCurrentDirectory.

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