Share via


_execl, _wexecl

Carrega e executa novos processos filho.

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
    Lista de ponteiros para os parâmetros.

Valor de retorno

Se for bem-sucedido, essas funções não retornam ao processo de chamada.Um valor retornado de – 1 indica um erro, que nesse caso o errno variável global é definida.

valor de errno

Descrição

E2BIG

O espaço necessário para os argumentos e configurações de ambiente excede 32 KB.

EACCES

O arquivo especificado tem uma violação de bloqueio ou compartilhamento.

EINVAL

Parâmetro inválido (um ou mais dos parâmetros era um ponteiro nulo ou seqüência vazia).

EMFILE

Muitos arquivos abertos (o arquivo especificado deve ser em aberto para determinar se é executável).

ENOENT

O arquivo ou caminho não foi encontrado.

ENOEXEC

O arquivo especificado não é executável ou tem um formato inválido do arquivo executável.

ENOMEM

Não há memória suficiente está disponível para executar o novo processo; corrompeu a memória disponível; ou existe um bloco inválido, indicando que o processo de chamada não foi alocado corretamente.

Comentários

Cada uma dessas funções carrega e executa um novo processo, passando cada argumento de linha de comando sistema autônomo um parâmetro separado.O primeiro argumento é o comando ou o nome de arquivo executável e o segundo argumento deve ser o mesmo sistema autônomo primeiro.Torna-se argv[0] no processo executado. O terceiro argumento é o primeiro argumento, argv[1], do processo que está sendo executado.

In Visual C++ 2005, o _execl funções validar seus parâmetros. Se qualquer um dos cmdname ou arg0 é um ponteiro nulo ou seqüência vazia, essas funções chamar o manipulador de parâmetro inválido sistema autônomo descrito em Validação de parâmetro Se a execução terá permissão para continuar, essas funções definido errno para EINVAL e retornar -1. Nenhum novo processo é executado.

Requisitos

Função

Cabeçalho necessário

Cabeçalho opcional

_execl

<processo.h>

<errno.h>

_wexecl

<processo.h> ou <wchar.h>

<errno.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Exemplo

Veja o exemplo _exec, _wexec funções.

Equivalente do NET Framework

Consulte também

Referência

Processo e ambiente de controle

_exec, _wexec funções

anular

atexit

sair, _exit

_onexit, _onexit_m

_spawn, _wspawn funções

sistema, _wsystem