_execle, _wexecle

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 _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
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	Arquivos demais estão abertos.(O arquivo especificado deve ser aberto para determinar se ele é executável.)
ENOENT	O arquivo ou o caminho não são encontrados.
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, que indica que o processo de chamada não esteve atribuído 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 carregar 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 configurações de ambiente.

Funções de _execle validam seus parâmetros.Se cmdname ou arg0 são um ponteiro zero ou uma cadeia de caracteres vazia, essas funções chamam o manipulador de parâmetro inválido, 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.