Aracılığıyla paylaş

_spawnlpe, _wspawnlpe

  • 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 _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ğı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 _spawnlpe veya _wspawnlpe (_P_WAIT için modebelirtilen) dönüş değeri, yeni işlemin çıkış durumudur. Zaman uyumsuz _spawnlpe veya _wspawnlpe (_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 yordamı çağırmak için özel olarak sıfır olmayan bir bağımsız değişken kullanıyorsa çıkış durumunu sıfır olmayan bir değere exit ayarlayabilirsiniz. Yeni işlem açıkça pozitif çıkış durumu ayarlamadıysa, pozitif çıkış durumu bir durdurma veya kesmenin neden olduğu anormal çıkışı 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 yeni bir işlem oluşturur ve yürütür, her komut satırı bağımsız değişkenini ayrı bir parametre olarak geçirir ve ortam ayarlarına bir işaretçi dizisi geçirir. Bu işlevler yürütülecek dosyayı bulmak için ortam değişkenini kullanır PATH .

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
_spawnlpe <process.h>
_wspawnlpe <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