_chdrive
Altera a unidade de trabalho atual.
Importante
Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.
int _chdrive(
int drive
);
Parâmetros
- drive
Um número inteiro de 1 a 26 que especifica a unidade de trabalho atual (1=A, 2=B e assim por diante).
Valor de retorno
Zero (0) se a unidade atual foi alterada trabalhando com êxito; se não, -1.
Comentários
Se drive não estiver no intervalo de 1 a 26, o manipulador de parâmetro inválido é chamado conforme descrito em Validação do parâmetro. Se a execução puder continuar, a função _chdrive retorna -1, errno é definido como EACCES e _doserrno é definido como ERROR_INVALID_DRIVE.
A função _chdrive não é thread-safe porque ela depende da função SetCurrentDirectory, que é thread-safe. Para usar com segurança _chdrive em um aplicativo multi-threaded, você deve fornecer sua sincronização de threads. Para obter mais informações, vá para Biblioteca MSDN, em seguida, pesquise por SetCurrentDirectory.
A função _chdrive altera somente a unidade de trabalho atual, _chdir altera o diretório de trabalho atual.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_chdrive |
<direct.h> |
Para obter mais informações, consulte Compatibilidade.
Exemplo
Consulte o exemplo de _getdrive.
Equivalência do .NET Framework
System::Environment::CurrentDirectory