Aracılığıyla paylaş

_execlpe, _wexeclpe

  • Makale

Yeni alt işlemleri yükler ve yürütü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 _execlpe(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp
);
intptr_t _wexeclpe(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *const *envp
);

Parametreler

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

arg0, ... argN
Parametrelere yönelik işaretçilerin listesi.

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.
EINVAL Geçersiz parametre.
EMFILE Çok fazla dosya açık (yürütülebilir olup olmadığını belirlemek için belirtilen dosya açılmalıdır).
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 düzgün 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şlem yükleyip yürütür, her komut satırı bağımsız değişkenini ayrı bir parametre olarak geçirir ve ayrıca ortam ayarlarına bir işaretçi dizisi geçirir. Bu işlevler yürütülecek dosyayı bulmak için ortam değişkenini kullanır PATH .

_execlpe İşlevler parametrelerini doğrular. cmdname Veya arg0 null işaretçiler veya boş bir dizeyse, bu işlevler Parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, bu işlevler olarak EINVAL ayarlanır errno ve -1 döndürür. Yeni işlem başlatılmaz.

Gereksinimler

İşlev Gerekli başlık İsteğe bağlı üst bilgi
_execlpe <process.h> <errno.h>
_wexeclpe <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