_execlpe, _wexeclpe

Artigo
02/25/2013

O carrega e executam novos processos filho.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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
Ponteiros a lista de parâmetros.
envp
Matriz de ponteiros para configurações de ambiente.

Valor de retorno

Se com êxito, essas funções não retornam ao processo de chamada.Um valor de retorno de – 1 indica um erro nesse caso, a variável global de errno é definido.

valor deerrno	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 um bloqueio ou compartilhar violação.
EINVAL	Parâmetro inválido.
EMFILE	Muitos arquivos abertos (o arquivo especificado deve ser aberto para determinar se ele é executável.)
ENOENT	O arquivo ou o 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 está disponível memória suficiente para executar o novo processo; a memória disponível foi danificada; um bloco ou inválido existir, indicando que o processo de chamada não esteve atribuído corretamente.

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

Comentários

Cada uma dessas funções carregar e executa um novo processo, passando cada argumento de linha de comando como um parâmetro separado e também passar uma matriz de ponteiros para configurações de ambiente.Essas funções usam a variável de ambiente de PATH para localizar o arquivo para executar.

Funções de _execlpe validam seus parâmetros.Se cmdname ou arg0 ponteiros são nulos ou cadeia de caracteres vazia, essas funções chamam o manipulador inválido de parâmetros como descrito em Validação de parâmetro.Se a execução é permitida continuar, este errno definir funções a EINVAL e retorne -1.Nenhum novo processo é iniciado.