_chdir, _wchdir

Artigo
03/12/2013

Altera o diretório de trabalho corrente.

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 _chdir( const char *dirname ); int _wchdir( const wchar_t *dirname );

Parâmetros

dirname
Caminho da nova pasta de trabalho.

Valor de retorno

Essas funções retornam um valor de 0 se com êxito.Um valor de retorno de 1 – indica a falha.Se o caminho especificado não pôde ser encontrado, errnoé definido como ENOENT.Se dirname é NULO, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, errnoé definido como EINVALe para a função retorna -1.

Comentários

As alterações de função de _chdiro diretório de trabalho corrente para o diretório especificado por dirname.O parâmetro de dirname deve se referir a um diretório existente.Essa função pode alterar o diretório de trabalho corrente em qualquer unidade.Se uma nova letra da unidade for especificada em dirname, a letra da unidade padrão é alterada também.Por exemplo, se Um é a letra da unidade padrão e \ COMPARTIMENTO é o diretório de trabalho corrente, as seguintes alterações de chamada o diretório de trabalho corrente para a unidade C e estabelecem C como a nova unidade padrão:

_chdir("c:\\temp");

Quando você usa o caractere de barra invertida (opcional) nos caminhos\, você deve colocar duas barras invertidas\\() na cadeia de caracteres literal de energia AC para representar uma barra invertida (\).

_wchdiré uma versão de largo- caractere de _chdir; o argumento de dirname a _wchdiré uma cadeia de caracteres. _wchdirde largo- caractere e _chdirse comporta de forma idêntica.

Mapeamento rotineiro de Genérico- texto:

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_MBCS definido	_UNICODE definido
_tchdir	_chdir	_chdir	_wchdir

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_chdir	<direct.h>	<errno.h>
_wchdir	<direct.h> ou <wchar.h>	<errno.h>

Para mais informações, consulte Compatibilidade de compatibilidade na introdução.

Exemplo

// crt_chdir.c
// arguments: C:\WINDOWS

/* This program uses the _chdir function to verify
   that a given directory exists. */

#include <direct.h>
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>

int main( int argc, char *argv[] )
{

   if(_chdir( argv[1] ) )
   {
      switch (errno)
      {
      case ENOENT:
         printf( "Unable to locate the directory: %s\n", argv[1] );
         break;
      case EINVAL:
         printf( "Invalid buffer.\n");
         break;
      default:
         printf( "Unknown error.\n");
      }
   }
   else
      system( "dir *.exe");
}