_execlpe, _wexeclpe

Artigo
06/09/2015

Carrega e executa novos processos filho.

Importante

Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

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 
);

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 excedem 32 KB.
EACCES	O arquivo especificado tem uma violação de bloqueio ou compartilhamento.
EINVAL	Parâmetro inválido.
EMFILE	Muitos arquivos abertos (o arquivo especificado deve ser aberto para determinar se ele é 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 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 adequadamente.

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

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 e passando também uma matriz de ponteiros para configurações de ambiente. Essas funções usam a variável de ambiente PATH para localizar o arquivo a ser executado.

As funções de _execlpe validam seus parâmetros. Se cmdname ou arg0 for um ponteiro nulo ou uma cadeia de caracteres vazia, essas funções chamarão o manipulador de parâmetro inválido, como 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.