_spawnle, _wspawnle

Makale
06/09/2015

Yeni bir işlem oluşturur 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 _spawnle(
   int mode,
   const char *cmdname,
   const char *arg0,
   const char *arg1,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wspawnle(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *arg0,
   const wchar_t *arg1,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *const *envp 
);

Parametreler

mode
Çağırma işlemi için yürütme modu.
cmdname
Yürütülecek dosyanın yolu.
arg0, arg1, ... argn
Bağımsız değişkenlere işaretçi listesi.arg0 bağımsız değişkeni genellikle cmdname nesnesine bir işaretçidir.arg1 ile argn arası bağımsız değişkenler, yeni bağımsız değişken listesini oluşturan karakter dizelerine işaretçilerdir.argn öğesinin ardından, bağımsız değişken listesinin sonu işaretlemek için bir NULL işaretçisi olmalıdır.
envp
Ortam ayarlarına işaretçi dizisi.

Dönüş Değeri

Eş zamanlı bir _spawnle veya _wspawnle (mode için belirlenen bir _P_WAIT ) üzerinden dönüş değeri yeni sürecin çıkış durumudur.Dönüş değeri eş zamanlı olmayan _spawnle veya _wspawnle (mode için belirlenen_P_NOWAIT veya _P_NOWAITO) süreci işler.İşlem normal şekilde sonlandırıldıysa çıkış durumu 0'dır.Üretilmiş işlem spesifik olarak, sıfır dışında bir bağımsız değişkenli exit yordamını çağırırsa, çıkış durumunu sıfır dışı bir değere ayarlayabilirsiniz.Yeni işlem açık bir şekilde pozitif çıkış durumu ayarlamadıysa, bir pozitif çıkış durumu, bir iptal veya kesintili anormal çıkışı gösterir.Getirilen -1 değeri, bir hatayı belirtir (yeni işlem başlatılmamış).Bu durumda, errno aşağıdaki değerlerin birine ayarlanır.

E2BIG
Bağımsız değişken listesi 1024 baytı aşıyor.
EINVAL
mode bağımsız değişkeni geçersiz.
ENOENT
Dosya ve yol bulunamadı.
ENOEXEC
Belirtilen dosya yürütülebilir değil veya geçersiz yürütülebilir dosya biçimine sahip.
ENOMEM
Yeni işlemi yürütmek için yeterli bellek yok.

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 oluşturur ve yürütür.

Bu işlevler, kendi parametrelerini doğrular.cmdname veya arg0 null bir işaretçi ya da boş dizeyse, Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılı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 üretilmedi.