_spawnl
, _wspawnl
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 _spawnl(
int mode,
const char *cmdname,
const char *arg0,
const char *arg1,
... const char *argn,
NULL
);
intptr_t _wspawnl(
int mode,
const wchar_t *cmdname,
const wchar_t *arg0,
const wchar_t *arg1,
... const wchar_t *argn,
NULL
);
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 argN
ini , harus ada penunjuk NULL
untuk menandai akhir daftar argumen.
Nilai hasil
Nilai pengembalian dari sinkron _spawnl
atau _wspawnl
(_P_WAIT
ditentukan untuk mode
) adalah status keluar dari proses baru. Nilai pengembalian dari asinkron _spawnl
atau _wspawnl
(_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
.
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.
Keterangan
Masing-masing fungsi ini membuat dan menjalankan proses baru, meneruskan setiap argumen baris perintah sebagai parameter terpisah.
Persyaratan
Rutin | Header yang diperlukan |
---|---|
_spawnl |
<process.h> |
_wspawnl |
<stdio.h> atau <wchar.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Contoh
Lihat contoh dalam _spawn
fungsi , _wspawn
.
Baca juga
Kontrol proses dan lingkungan
_spawn
, _wspawn
fungsi
abort
atexit
_exec
, _wexec
fungsi
exit
, _Exit
, _exit
_flushall
_getmbcp
_onexit
, _onexit_m
_setmbcp
system
, _wsystem
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk