_chdir, _wchdir

Artikel
06/09/2015

Ändert das aktuelle Arbeitsverzeichnis.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.

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

Parameter

dirname
Pfad des neuen Arbeitsverzeichnisses.

Rückgabewert

Diese Funktionen geben bei Erfolg den Wert 0 zurück. Ein Rückgabewert von 1 gibt einen Fehler an. Wenn der angegebene Pfad nicht gefunden werden kann, wird errno auf ENOENT festgelegt. Wenn dirname NULL ist, wird der ungültige Parameterhandler wie in Parametervalidierung beschrieben aufgerufen. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL gesetzt, und die Funktion gibt – 1 zurück.

Hinweise

Die _chdir -Funktion ändert das aktuelle Arbeitsverzeichnis und wählt das Verzeichnis aus, das durch dirname angegeben ist. Der dirname-Parameter muss auf ein vorhandenes Verzeichnis verweisen. Diese Funktion kann das aktuelle Arbeitsverzeichnis auf jedem beliebigen Laufwerk ändern. Wenn ein neuer Laufwerkbuchstabe in dirname angegeben wird, wird der Standardlaufwerkbuchstabe ebenfalls geändert. Wenn z. B. A der Standardlaufwerkbuchstabe und \BIN das aktuelle Arbeitsverzeichnis ist, ändert der folgende Aufruf das aktuelle Arbeitsverzeichnis in C und legt C als neues Standardlaufwerk fest:

_chdir("c:\\temp");

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

_wchdir ist eine Breitzeichenversion von _chdir. Das dirname-Argument für _wchdir ist eine Zeichenfolge mit Breitzeichen. _wchdir und _chdir verhalten sich andernfalls identisch.

Zuordnung generischer 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 Informationen zur Kompatibilität finden Sie unter Kompatibilität.

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