_execlpe, _wexeclpe

Makale
06/09/2015

Yeni alt işlemleri yükler ve yürütür.

Ö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.

intptr_t _execlpe( 
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wexeclpe( 
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *const *envp 
);

Parametreler

cmdname
Yürütülecek dosyanın yolu.
arg0, ...argn
Parametreler için işaretçiler listesi.
envp
Ortam ayarlarına işaretçi dizisi.

Dönüş Değeri

Başarılı olursa, bu işlevler çağırma işlemine geri gitmez.Getirilen -1 değeri bir hatayı belirtir, bu durumda errno global değişkeni ayarlanır.

errno değeri	Tanımlama
E2BIG	Bağımsız değişkenler ve ortam ayarları için gereken alan 32 KB'yı aşıyor.
EACCES	Belirtilen dosyada bir kilitleme veya paylaşma ihlali var.
EINVAL	Geçersiz parametre.
EMFILE	Çok fazla sayıda dosya açık (belirtilen dosyanın yürütülebilir olup olmadığını belirlemek için, dosyanın açılması gerekir).
ENOENT	Dosya veya yol bulunamadı.
ENOEXEC	Belirtilen dosya yürütülebilir değil veya geçersiz bir yürütülebilir dosya biçimine sahip.
ENOMEM	Yeni işlemi yürütmek için yeterli bellek yok; kullanılabilir bellek bozulmuş; veya, çağırma işleminin doğru şekilde ayrılmadığını gösterecek şekilde, geçersiz bir engel var.

Bunlar ve gelen diğer kodlar hakkında bilgi için, bkz. _doserrno, errno, _sys_errlist ve _sys_nerr.

Notlar

Bu işlevlerin her biri, her komut satırı bağımsız değişkenini ayrı bir parametre olarak geçirerek ve ayrıca bir işaretçiler dizisini ortam ayarlarına geçirerek, yeni bir işlem yükler ve yürütür.Bu işlevler, yürütülecek dosyayı bulmak için, PATH ortam değişkenini kullanır.

_execlpe işlevleri kendi parametrelerini doğrular.cmdname veya arg0 null bir işaretçi ya da boş dizeyse bu işlevler Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır.Yürütmenin devam etmesine izin verilirse bu işlevler errno öğesini EINVAL olarak ayarlar ve -1 döndürür.Yeni bir işlem başlatılmadı.