_spawnlpe, _wspawnlpe

Makale
03/27/2013

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

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

intptr_t _spawnlpe(
   int mode,
   const char *cmdname,
   const char *arg0,
   const char *arg1,
   ... const char *argn,
   NULL,
   const char *const *envp 
);
intptr_t _wspawnlpe(
   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ğıran işlemin yürütme modunu.
cmdname
Yürütülecek dosyasının yolu.
arg0, arg1, ... argn
İşaretçiler bağımsız değişkenler listesi.arg0 Bağımsız değişken ise genellikle bir işaretçi cmdname.Bağımsız değişkenler arg1 ile argn yeni bağımsız değişken listesi formunda karakter dizeleri için işaretçiler.Aşağıdaki argn, olması gerekir 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 _spawnlpe veya _wspawnlpe (_P_WAIT için belirtilen mode) yeni işlemin çıkış durumudur.Zaman uyumsuz bir gelen bir dönüş değeri _spawnlpe veya _wspawnlpe (_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.Oluşturulan işlemi çağırmak için sıfır olmayan bir bağımsız değişken özellikle kullanıyorsa, çıkış durumu sıfır dışında bir değere ayarlamak exit yordamına girildi.Yeni işlem pozitif çıkış durumu açıkça ayarlamadıysanız, olağan dışı bir çıkış nedeni bir durdurma veya kesme 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: errno, _doserrno, _sys_errlist ve _sys_nerr.

Notlar

Bu işlevlerden her biri oluşturur ve yeni bir işlem yürütür, her komut satırı bağımsız ayrı bir parametre olarak geçirir ve işaretçiler dizisi ortam ayarlarını aktarır.Bu işlevleri kullanma PATH ortam değişkeni yürütmek için dosyayı bulmak için.

Bu işlevler, kendi parametrelerini doğrulayın.Ya da, cmdname veya arg0 açıklandığı bir null işaretçi parametresi geçersiz işleyici çağrılır veya boş bir dize 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.