_chdir, _wchdir

Makale
03/26/2013

Geçerli çalışma dizini değiştirir.

Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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

Parametreler

dirname
Yeni çalışma dizininin yolu.

Dönüş Değeri

Bu işlevler, başarılı olursa 0 değerini döndürür.Dönüş değeri –1 başarısız olduğunu gösterir.Belirtilen yol bulunamadı, errno ayarlamak ENOENT.dirname Null, açıklandığı gibi geçersiz bir parametre işleyici çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilip verilmediğini errno ayarlamak EINVAL ve işlev-1 değerini döndürür.

Notlar

_chdir İşlevi geçerli çalışma dizini olarak belirtilen dizine değiştirir dirname.dirname Parametresi için varolan bir dizin başvurmalıdır.Bu işlev, herhangi bir sürücüdeki geçerli çalışma dizinini değiştirebilirsiniz.Yeni bir sürücü harfi belirtilmezse dirname, varsayılan sürücü harfini de değişti.Örneğin, bir varsayılan sürücü harfidir ve geçerli çalışma dizinine \BIN ise, aşağıdaki çağrı c sürücüsü için geçerli çalışma dizinini değiştirir ve yeni varsayılan sürücü olarak c kurar:

_chdir("c:\\temp");

İsteğe bağlı bir ters eğik çizgi karakteri kullandığınızda (\), yolda iki ters eğik çizgi koyun gerekir (\\) c dize değişmezinde tek bir ters eğik çizgi temsil etmek için (\).

_wchdirgeniş karakter sürümü _chdir; dirname bağımsız değişkeni _wchdir bir geniş karakter dizesi. _wchdirve _chdir Aksi takdirde aynı şekilde davranır.

Genel metin yordamını eşleme:

Tchar.h yordamına girildi	_UNICODE ve _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tchdir	_chdir	_chdir	_wchdir

Gereksinimler

Yordamı	Gerekli başlık	İsteğe bağlı üstbilgi
_chdir	<direct.h>	<errno.h>
_wchdir	<direct.h> veya <wchar.h>	<errno.h>

Daha fazla uyumluluk bilgileri için bkz: Uyumluluk giriş.

Örnek

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