_execle, _wexecle

Artigo
06/09/2015

Carrega e executa novos processos filho.

Importante

Não é possível usar essa API em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

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 dos ponteiros dos parâmetros.
envp
Matriz de ponteiros para configurações de ambiente.

Valor de retorno

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

Valor errno	Descrição
E2BIG	O espaço necessário para os argumentos e as configurações de ambiente exceder 32 KB.
EACCES	O arquivo especificado tem uma violação de bloqueio ou compartilhamento.
EINVAL	Parâmetro inválido.
EMFILE	Muitos arquivos estão abertos. (O arquivo especificado deve ser aberto para determinar se é um executável.)
ENOENT	Arquivo ou caminho não 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 para executar o novo processo; a memória disponível foi danificada; um bloco ou inválido existir, que indica que o processo de chamada não esteve atribuída corretamente.

Para obter mais informações sobre esses códigos de retorno, consulte _doserrno, errno, _sys_errlist, e _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 passe uma matriz de ponteiros para as configurações de ambiente.

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