_spawnlp, _wspawnlp

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 _spawnlp(
   int mode,
   const char *cmdname,
   const char *arg0,
   const char *arg1,
   ... const char *argn,
   NULL 
);
intptr_t _wspawnlp(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *arg0,
   const wchar_t *arg1,
   ... const wchar_t *argn,
   NULL 
);

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.

Dönüş Değeri

Dönüş değeri eş zamanlı _spawnlp veya _wspawnlp ( mode için belirtilen _P_WAIT ) yeni bir işlem çıkış durumudur.Dönüş değeri eş zamanlı olmayan _spawnlp veya _wspawnlp (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 yürütülecek dosyayı bulmak için PATH ortam değişkenini kullanarak yeni bir işlem oluşturur ve yürütür.

Bu işlevler, kendi parametrelerini doğrular.cmdname veya arg0 boş bir dizeye veya boş bir işaretçi ise bu işlevler Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre özel durumunu üretir.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.