_execvp
, _wexecvp
Memuat dan menjalankan proses anak 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 _execvp(
const char *cmdname,
const char *const *argv
);
intptr_t _wexecvp(
const wchar_t *cmdname,
const wchar_t *const *argv
);
Parameter
cmdname
Jalur file yang akan dijalankan.
argv
Array pointer ke parameter.
Nilai hasil
Jika berhasil, fungsi-fungsi ini tidak kembali ke proses panggilan. Nilai pengembalian -1 menunjukkan kesalahan, dalam hal errno
ini variabel global diatur.
errno nilai |
Deskripsi |
---|---|
E2BIG |
Ruang yang diperlukan untuk argumen dan pengaturan lingkungan melebihi 32 KB. |
EACCES |
File yang ditentukan memiliki pelanggaran penguncian atau berbagi. |
EINVAL |
Parameter tidak valid. |
EMFILE |
Terlalu banyak file yang terbuka (file yang ditentukan harus dibuka untuk menentukan apakah file dapat dieksekusi). |
ENOENT |
File atau jalur tidak ditemukan. |
ENOEXEC |
File yang ditentukan tidak dapat dieksekusi atau memiliki format file yang dapat dieksekusi yang tidak valid. |
ENOMEM |
Tidak tersedia cukup memori untuk menjalankan proses baru; memori yang tersedia telah rusak; atau ada blok yang tidak valid, menunjukkan bahwa proses panggilan tidak dialokasikan dengan benar. |
Untuk informasi selengkapnya tentang kode pengembalian ini dan lainnya, lihat errno
, , _doserrno
_sys_errlist
, dan _sys_nerr
.
Keterangan
Masing-masing fungsi ini memuat dan menjalankan proses baru, meneruskan array pointer ke argumen baris perintah dan menggunakan PATH
variabel lingkungan untuk menemukan file yang akan dijalankan.
Fungsi memvalidasi _execvp
parameternya. Fungsi-fungsi ini memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter, ketika:
cmdname
adalah penunjuk null,argv
adalah penunjuk null atau penunjuk ke array kosong,- array berisi string kosong sebagai argumen pertama.
Jika eksekusi diizinkan untuk dilanjutkan oleh handler, fungsi-fungsi ini diatur errno
ke EINVAL
, dan mengembalikan -1. Tidak ada proses yang diluncurkan.
Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.
Persyaratan
Function | Header yang diperlukan | Header opsional |
---|---|---|
_execvp |
<process.h> | <errno.h> |
_wexecvp |
<process.h> atau <wchar.h> | <errno.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Contoh
Lihat contoh dalam _exec
fungsi , _wexec
.
Baca juga
Kontrol proses dan lingkungan
_exec
, _wexec
fungsi
abort
atexit
exit
, _Exit
, _exit
_onexit
, _onexit_m
_spawn
, _wspawn
fungsi
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