_chdir, _wchdir

Artikel
03/12/2013

Ändert das aktuelle Arbeitsverzeichnis.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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

Parameter

dirname
Pfad des neuen Arbeitsverzeichnisses.

Rückgabewert

Diese Funktionen geben den Wert 0 zurück, wenn erfolgreich.Ein Rückgabewert von - 1 gibt Fehler an.Wenn der angegebene Pfad nicht gefunden werden konnte, wird errno zu ENOENT festgelegt.Wenn dirname NULL ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EINVAL und - Funktion -1 festgelegt.

Hinweise

Die _chdir jeweiligen, die das aktuelle Arbeitsverzeichnis auf das Verzeichnis durch dirname angegeben hat.Der dirname-Parameter muss ein vorhandenes Verzeichnis verweisen.Diese Funktion kann das aktuelle Arbeitsverzeichnis auf jedem Laufwerk ändern.Wenn ein neuer Laufwerkbuchstabe in dirname angegeben ist, wird der standardmäßige Laufwerkbuchstabe ebenfalls geändert.Wenn beispielsweise ein Standard Laufwerkbuchstabe ist und \BIN das aktuelle Arbeitsverzeichnis ist, richtet die folgenden Aufrufsänderungen das aktuelle Arbeitsverzeichnis für Laufwerk C und C als neue Standardlaufwerk ein:

_chdir("c:\\temp");

Wenn Sie den optionalen umgekehrten Schrägstrich (\) in der Pfade verwenden, müssen Sie zwei umgekehrte Schrägstriche (\\) in Wechselstrom-Zeichenfolgenliteral platzieren, um einen einzelnen umgekehrten Schrägstrich (\) darzustellen.

_wchdir ist eine Breitzeichen-Version von _chdir; dirname das Argument an _wchdir ist eine Zeichenfolge mit Breitzeichen . _wchdir und _chdir verhalten sich andernfalls identisch.

Zuordnung generische Textroutinen:

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tchdir	_chdir	_chdir	_wchdir

Anforderungen

Routine	Erforderlicher Header	Optionaler Header
_chdir	<direct.h>	<errno.h>
_wchdir	<direct.h> oder <wchar.h>	<errno.h>

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

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