_execl, _wexecl

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 _execl(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL
);
intptr_t _wexecl(
   const wchar_t *cmdname,
   const wchar_t *arg0,
   ... const wchar_t *argn,
   NULL
);

Parâmetros

cmdname
Caminho do arquivo a ser executado.

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

Retornar valor

Se bem-sucedidas, essas funções não retornam ao processo de chamada. Um valor de retorno 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 (um ou mais dos parâmetros era um ponteiro nulo ou uma cadeia de caracteres vazia).
EMFILE	Muitos arquivos são abertos (o arquivo especificado deve ser aberto para determinar se é 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, indicando que o processo de chamada não foi alocado corretamente.

Comentários

Cada uma dessas funções carrega e executa um novo processo, passando cada argumento de linha de comando como um parâmetro separado. O primeiro argumento é o nome do arquivo executável ou comando e o segundo argumento deve ser o mesmo que o primeiro. Ele se torna argv[0] no processo executado. O terceiro argumento é o primeiro argumento, argv[1], do processo que está sendo executado.

As funções _execl validam seus parâmetros. Se ou for um ponteiro nulo ou cmdnamearg0 uma cadeia de caracteres vazia, essas funções invocarão o manipulador de parâmetros inválido, conforme descrito em Validação de parâmetro Se a execução tiver permissão para continuar, essas funções serão definidas errno como EINVAL e retornarão -1. Nenhum processo novo é executado.

Requisitos

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

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Veja o exemplo em _exec, _wexec functions.

Confira também

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