_chdir, _wchdir

Articolo
03/26/2013

Modifica la cartella di lavoro corrente.

Importante
Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

int _chdir( 
   const char *dirname 
);
int _wchdir( 
   const wchar_t *dirname 
);

Parametri

dirname
Percorso della nuova cartella di lavoro.

Valore restituito

Queste funzioni restituiscono un valore 0 se si riesce.Restituito un valore pari a 1 indica un errore.Se il percorso specificato non è disponibile, errnoè impostato su ENOENT.Se dirname è NULL, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, errnoè impostato su EINVALe alla funzione restituisce -1.

Note

Le modifiche che la funzione di _chdirla cartella di lavoro corrente nella directory specificata da dirname.Il parametro di dirname deve fare riferimento a una directory esistente.Questa funzione può modificare la cartella di lavoro corrente in qualsiasi unità.Se una nuova lettera di unità specificata in dirname, la lettera di unità predefinito viene modificata anche.Ad esempio, se un oggetto è la lettera di unità predefinito e \ BIN è la cartella di lavoro corrente, le modifiche seguenti di chiamata la cartella di lavoro corrente per unità C e stabilisce C come la nuova unità predefinito:

_chdir("c:\\temp");

Quando si utilizza il carattere barra rovesciata (facoltativo)\in percorsi, è necessario inserire due barre rovesciate (\\) nel valore letterale stringa c per rappresentare una barra rovesciata singola (\).

_wchdirè una versione a caratteri estesi di _chdir; l'argomento di dirname a _wchdirè una stringa di caratteri di. _wchdire _chdirsi comporta in modo identico in caso contrario.

Mapping di routine a testo generico:

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_tchdir	_chdir	_chdir	_wchdir

Requisiti

Routine	Intestazione obbligatoria	Intestazione facoltativa
_chdir	<direct.h>	<errno.h>
_wchdir	<direct.h> o <wchar.h>	<errno.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

// 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");
}