_execve, _wexecve

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 _execve(
   const char *cmdname,
   const char *const *argv,
   const char *const *envp
);
intptr_t _wexecve(
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp
);

Parameter

cmdname
Jalur file yang akan dijalankan.

argv
Array pointer ke parameter.

envp
Array pointer ke pengaturan lingkungan.

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 penunjuk ke argumen baris perintah dan array penunjuk ke pengaturan lingkungan.

_execve dan _wexecve memvalidasi 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
_execve	<process.h>	<errno.h>
_wexecve	<process.h> atau <wchar.h>	<errno.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh dalam _execfungsi , _wexec .

Baca juga

Kontrol proses dan lingkungan
_exec, _wexec fungsi
abort
atexit
exit, _Exit, _exit
_onexit, _onexit_m
_spawn, _wspawn fungsi
system, _wsystem