Aracılığıyla paylaş

_spawnle, _wspawnle

  • Makale

Yeni bir işlem oluşturur ve yürütür.

Önemli

Bu API, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.

Sözdizimi

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şkenlerin işaretçileri listesi. arg0 Bağımsız değişken genellikle için cmdnamebir işaretçidir. aracılığıyla argN bağımsız değişkenler, yeni bağımsız arg1 değişken listesini oluşturan karakter dizelerinin işaretçileridir. ardından argN, bağımsız değişken listesinin sonunu işaretlemek için bir NULL işaretçi olmalıdır.

envp
Ortam ayarlarına yönelik işaretçi dizisi.

Dönüş değeri

Zaman uyumlu _spawnle veya _wspawnle (_P_WAIT için modebelirtilen) dönüş değeri, yeni işlemin çıkış durumudur. Zaman uyumsuz _spawnle veya _wspawnle (_P_NOWAIT veya _P_NOWAITO için modebelirtilen) değerinden döndürülen değer, işlem tutamacıdır. İşlem normal şekilde sonlandırıldıysa çıkış durumu 0 olur. Oluşturulan işlem özel olarak sıfır olmayan bağımsız değişkenle yordamı çağırıyorsa exit çıkış durumunu sıfır olmayan bir değere ayarlayabilirsiniz. Yeni işlem açıkça pozitif çıkış durumu ayarlamadıysa, pozitif çıkış durumu durdurma veya kesme ile anormal bir çıkış olduğunu gösterir. -1 dönüş değeri bir hatayı gösterir (yeni işlem başlatılmaz). Bu durumda, errno aşağıdaki değerlerden birine ayarlanır.

Value Açıklama
E2BIG Bağımsız değişken listesi 1024 baytı aşıyor.
EINVAL mode bağımsız değişkeni geçersiz.
ENOENT Dosya veya 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 diğer iade kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

Bu işlevlerin her biri, her komut satırı bağımsız değişkenini ayrı bir parametre olarak geçirerek ve ayrıca ortam ayarlarına bir işaretçi dizisi geçirerek yeni bir işlem oluşturur ve yürütür.

Bu işlevler parametrelerini doğrular. Ya da cmdname arg0 boş bir dize veya null işaretçiyse, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler olarak EINVALayarlanır errno ve -1 döndürür. Yeni bir işlem oluşturulmaz.

Gereksinimler

Yordam Gerekli başlık
_spawnle <process.h>
_wspawnle <stdio.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

içindeki örne _spawnbakın. _wspawn İşlevler.

Ayrıca bkz.

İşlem ve ortam denetimi
_spawn, _wspawn işlevler
abort
atexit
_exec, _wexec işlevler
exit, _Exit, _exit
_flushall
_getmbcp
_onexit, _onexit_m
_setmbcp
system, _wsystem