_spawnv, _wspawnv

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 _spawnv(
   int mode,
   const char *cmdname,
   const char *const *argv 
);
intptr_t _wspawnv(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *const *argv 
);

Parametreler

mode
Çağırma işlemi için yürütme modu.
cmdname
Yürütülecek dosyanın yolu.
argv
İşaretçiler bağımsız değişkenler dizisi.argv[0] bağımsız değişkeni, genellikle, gerçek modda bir yola veya korumalı modda program adına bir işaretçidir ve argv[1] ile argv[n] arası değişkenler, yeni bağımsız değişken listesini oluşturan karakter dizelerine işaretçilerdir.argv[n +1] bağımsız değişkeninin, bir bağımsız değişken listesinin sonunu işaretlemek için bir NULL işaretçi olması gerekir.

Dönüş Değeri

Dönüş değeri eş zamanlı _spawnv veya _wspawnv ( _P_WAIT için belirtilen mode ) yeni bir işlem çıkış durumudur.Dönüş değeri eş zamanlı olmayan _spawnv veya _wspawnv (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, komut satırı bağımsız değişkenlerine bir işaretçiler dizisi geçirerek yeni bir işlem oluşturur ve yürütür.

Bu işlevler, kendi parametrelerini doğrular.cmdname veya argv boş bir işaretçi ise veya argv boş işaretçiyi gösteriyorsa ya da argv[0] boş bir dize ise, geçersi parametre işleyicisi Parametre Doğrulama konusunda açıklanan şekilde ç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.