Partilhar via


_execle, _wexecle

Carrega e executa novos processos filho.

Importante

Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

intptr_t _execle(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL,
   const char *const *envp
);
intptr_t _wexecle(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL,
   const char *const *envp
);

Parâmetros

cmdname
Caminho do arquivo a ser executado.

arg0, ... argN
Lista de ponteiros para os parâmetros.

envp
Matriz de ponteiros para as configurações de ambiente.

Valor retornado

Se forem bem-sucedidas, essas funções não retornarão ao processo de chamada. Um valor retornado de -1 indica um erro, caso em que a errno variável global é definida.

errno valor Descrição
E2BIG O espaço necessário para os argumentos e as configurações de ambiente excede 32 KB.
EACCES O arquivo especificado tem uma violação de compartilhamento ou de bloqueio.
EINVAL Parâmetro inválido.
EMFILE Há muitos arquivos abertos. (O arquivo especificado deve ser aberto para determinar se ele é executável.)
ENOENT O arquivo ou caminho não foi encontrado.
ENOEXEC O arquivo especificado não é executável ou tem um formato de arquivo executável inválido.
ENOMEM Não há memória suficiente disponível para executar o novo processo; a memória disponível foi corrompida; ou existe um bloco inválido, o que indica que o processo de chamada não foi alocado corretamente.

Para obter mais informações sobre esses códigos de retorno, consulte errno, _doserrno, _sys_errliste _sys_nerr.

Comentários

Cada uma dessas funções carrega e executa um novo processo e passa cada argumento de linha de comando como um parâmetro separado e passa uma matriz de ponteiros para as configurações de ambiente.

As funções _execle validam seus parâmetros. Se cmdname or arg0 for um ponteiro nulo ou uma cadeia de caracteres vazia, essas funções invocarão o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essas funções definirão errno como EINVAL e retornarão -1. Nenhum processo novo é inicializado.

Requisitos

Função Cabeçalho necessário Cabeçalho opcional
_execle <processo.h> <errno.h>
_wexecle <process.h> ou <wchar.h> <errno.h>

Para obter mais informações, consulte Compatibilidade.

Exemplo

Veja o exemplo em _exec, _wexec funções.

Confira também

Controle de processo e ambiente
_exec, _wexec funções
abort
atexit
exit, _Exit, _exit
_onexit, _onexit_m
_spawn, _wspawn funções
system, _wsystem