_execl, _wexecl

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 _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
Ponteiros a lista de parâmetros.

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 de errno	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 (um ou mais dos parâmetros eram um ponteiro zero ou uma cadeia de caracteres vazia).
EMFILE	Muitos arquivos 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, indicando que o processo de chamada não esteve atribuído corretamente.

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.O primeiro argumento é o comando ou o nome do arquivo executável, e o segundo argumento deve ser o mesmo que o primeiro.Transformações argv[0] no processo executado.O segundo argumento é o primeiro argumento, argv[1], o processo que está sendo executado.

Funções de _execl validam seus parâmetros.Se cmdname ou arg0 são um ponteiro zero 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, neste errno definido na EINVAL funções e retorne -1.Nenhum novo processo é executado.