_spawnve, _wspawnve

Makale
03/26/2013

Oluşturur ve yeni bir işlem yürütür.

Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

intptr_t _spawnve(
   int mode,
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wspawnve(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

Parametreler

mode
Bir arama işlemi yürütme modunu.
cmdname
Yürütülecek dosyasının yolu.
argv
İşaretçiler bağımsız değişkenler dizisi.Bağımsız değişken argv[0] genellikle bir yol için bir işaretçi korumalı modda gerçek modda veya program adı olan ve argv[1] ile argvn yeni bağımsız değişken listesi oluşturuluyor karakter dizeleri için işaretçiler.Bağımsız değişken argvn + 1] olması gereken bir NULL bağımsız değişken listesinin sonuna işaretlemek için işaretçi.
envp
Ortam ayarlarını işaretçiler içeren dizi.

Dönüş Değeri

Zaman uyumlu bir gelen bir dönüş değeri _spawnve veya _wspawnve (_P_WAIT için belirtilen mode) yeni işlemin çıkış durumudur.Zaman uyumsuz bir gelen bir dönüş değeri _spawnve veya _wspawnve (_P_NOWAIT veya _P_NOWAITO için belirtilen mode) işlem tutamacıdır.Çıkış durumu 0 ise işlem olağan biçimde sona erdi.Üretilen işlem özellikle çağırırsa, çıkış durumu sıfır dışında bir değere ayarlayabilirsiniz exit sıfır olmayan bir bağımsız değişken ile rutin.Yeni işlem pozitif çıkış durumu açıkça ayarlamadıysanız, olağan dışı bir çıkış bir durdurma veya kesme ile pozitif çıkış durumu gösterir.Dönüş değeri –1 (yeni işlem başlatılmamış) bir hata gösterir.Bu durumda, errno aşağıdaki değerlerden birine ayarlayın.

E2BIG
Bağımsız değişken listesi 1024 baytı aşıyor.
EINVAL
modebağımsız değişken geçersiz.
ENOENT
Dosya veya yol bulunamadı.
ENOEXEC
Belirtilen dosya yürütülebilir değil veya çalıştırılabilir dosya biçimi geçersiz.
ENOMEM
Yeni işlem yürütmek yeterli bellek yok.

Bunlar ve diğer dönüş kodları hakkında daha fazla bilgi için bkz: _doserrno, hatano, _sys_errlist ve _sys_nerr.

Notlar

Bu işlevlerden her biri oluşturur ve komut satırı bağımsız değişkenleri ve ortam ayarlarını işaretçiler bir dizi bir dizi işaretçilerinin geçirilmesi, yeni bir işlem yürütür.

Bu işlevler, kendi parametrelerini doğrulayın.Ya da, cmdname veya argv bir null işaretçi veya argv null işaretçi işaret eden ya da argv[0] boş bir dize açıklandığı gibi geçersiz bir parametre işleyici çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilirse, bu işlevler kümesi errno için EINVALve -1 döndürür.Yeni bir işlem kökenli.