_chdir, _wchdir

Makale
06/09/2015

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

Önemli
Bu API, Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamaz.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

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 öğesi NULL ise, Parametre Doğrulama içinde açıklandığı şekilde geçersiz parametre işleyici çağrılır.Yürütülmesine devam etmek için izin verilip verilmediğini errno ayarlamak EINVAL ve işlevi-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ü harfiyle alanında belirtilmişse, dirname, varsayılan sürücü harfini de değiştirilir.Örneğin, bir varsayılan sürücü harfidir ve geçerli çalışma dizinine \BIN ise, şu ç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 (\).

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

Olağan genel metin eşleme:

Tchar.h yordamı	_UNICODE ve _MBCS tanımlanmaz	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tchdir	_chdir	_chdir	_wchdir

Gereksinimler

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

Daha fazla ek uyumluluk bilgileri için bkz. Uyumluluk.

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