_spawnle, _wspawnle

Membuat dan menjalankan proses baru.

Penting

API ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

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
);

Parameter

mode
Mode eksekusi untuk proses panggilan.

cmdname
Jalur file yang akan dijalankan.

arg0, , arg1... argN
Daftar pointer ke argumen. Argumen arg0 biasanya penunjuk ke cmdname. Argumen arg1 melalui argN adalah penunjuk ke string karakter yang membentuk daftar argumen baru. Berikut argNini , harus ada penunjuk NULL untuk menandai akhir daftar argumen.

envp
Array pointer ke pengaturan lingkungan.

Nilai hasil

Nilai pengembalian dari sinkron _spawnle atau _wspawnle (_P_WAIT ditentukan untuk mode) adalah status keluar dari proses baru. Nilai pengembalian dari asinkron _spawnle atau _wspawnle (_P_NOWAIT atau _P_NOWAITO ditentukan untuk mode) adalah handel proses. Status keluar adalah 0 jika proses dihentikan secara normal. Anda dapat mengatur status keluar ke nilai bukan nol jika proses yang ditelurkan secara khusus memanggil exit rutinitas dengan argumen bukan nol. Jika proses baru tidak secara eksplisit menetapkan status keluar positif, status keluar positif menunjukkan keluarnya abnormal dengan batal atau mengganggu. Nilai pengembalian -1 menunjukkan kesalahan (proses baru belum dimulai). Dalam hal ini, errno diatur ke salah satu nilai berikut.

Nilai	Deskripsi
E2BIG	Daftar argumen melebihi 1024 byte.
EINVAL	mode argumen tidak valid.
ENOENT	File atau jalur tidak ditemukan.
ENOEXEC	File yang ditentukan tidak dapat dieksekusi atau memiliki format file yang dapat dieksekusi tidak valid.
ENOMEM	Tidak tersedia cukup memori untuk menjalankan proses baru.

Untuk informasi selengkapnya tentang kode pengembalian ini dan lainnya, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Masing-masing fungsi ini membuat dan menjalankan proses baru, meneruskan setiap argumen baris perintah sebagai parameter terpisah dan juga meneruskan array pointer ke pengaturan lingkungan.

Fungsi-fungsi ini memvalidasi parameternya. Jika atau cmdname arg0 adalah string kosong atau penunjuk null, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi-fungsi ini diatur errno ke EINVAL, dan mengembalikan -1. Tidak ada proses baru yang ditelurkan.

Persyaratan

Rutin	Header yang diperlukan
_spawnle	<process.h>
_wspawnle	<stdio.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh dalam _spawnfungsi , _wspawn .

Lihat juga

Kontrol proses dan lingkungan
_spawn, _wspawn fungsi
abort
atexit
_exec, _wexec fungsi
exit, , _Exit_exit
_flushall
_getmbcp
_onexit, _onexit_m
_setmbcp
system, _wsystem