Aracılığıyla paylaş

_execvpe, _wexecvpe

  • Makale

Yeni alt işlemleri yükler ve çalıştırı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 _execvpe(
   const char *cmdname,
   const char *const *argv,
   const char *const *envp
);
intptr_t _wexecvpe(
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp
);

Parametreler

cmdname
Yürütülecek dosyanın yolu.

argv
Parametrelere yönelik işaretçi dizisi.

envp
Ortam ayarlarına yönelik işaretçi dizisi.

Dönüş değeri

Başarılı olursa, bu işlevler çağrı işlemine geri dönmez. -1 dönüş değeri bir hatayı gösterir ve bu durumda errno genel değişken ayarlanır.

errno değer Açıklama
E2BIG Bağımsız değişkenler ve ortam ayarları için gereken alan 32 KB'ı aşıyor.
EACCES Belirtilen dosya bir kilitleme veya paylaşım ihlaline sahip.
EMFILE Çok fazla dosya açık. (Yürütülebilir olup olmadığını belirlemek için belirtilen dosyanın açılması gerekir.)
ENOENT Dosya veya yol bulunamadı.
ENOEXEC Belirtilen dosya yürütülebilir değil veya geçersiz bir yürütülebilir dosya biçimine sahip.
ENOMEM Yeni işlemi yürütmek için yeterli bellek yok; kullanılabilir bellek bozulmuş; veya çağırma işleminin doğru ayrılmadığını gösteren geçersiz bir blok var.

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şlemi yükleyip yürütür ve bir dizi işaretçiyi komut satırı bağımsız değişkenlerine ve bir işaretçi dizisini ortam ayarlarına geçirir. Bu işlevler yürütülecek dosyayı bulmak için ortam değişkenini kullanır PATH .

_execvpe İşlevler parametrelerini doğrular. Bu işlevler, Parametre doğrulama bölümünde açıklandığı gibi, aşağıdaki durumlarda geçersiz parametre işleyicisini çağırır:

  • cmdname null işaretçidir,
  • argv boş bir dizi için null işaretçi veya işaretçidir,
  • dizi, ilk bağımsız değişken olarak boş bir dize içerir.

Yürütmenin işleyici tarafından devam etmesi için izin verilirse, bu işlevler olarak EINVALayarlanır errno ve -1 döndürür. Hiçbir işlem başlatılmaz.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Gereksinimler

İşlev Gerekli başlık İsteğe bağlı üst bilgi
_execvpe <process.h> <errno.h>
_wexecvpe <process.h> veya <wchar.h> <errno.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

içindeki örne _execbakın. _wexec İşlevler.

Ayrıca bkz.

İşlem ve ortam denetimi
_exec, _wexec işlevler
abort
atexit
exit, _Exit, _exit
_onexit, _onexit_m
_spawn, _wspawn işlevler
system, _wsystem