Compartilhar via


_execlpe, _wexeclpe

Carrega e executa novos processos filho.

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 para executar.

  • arg0, ...argn
    Lista de ponteiros para os parâmetros.

  • envp
    Matriz de ponteiros para as configurações de ambiente.

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.

errno valor

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.

EMFILE

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

ENOENT

O arquivo ou caminho não 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.

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 carrega e executa um novo processo, passando cada argumento de linha de comando sistema autônomo um parâmetro separado e também passando uma matriz de ponteiros para sistema autônomo configurações de ambiente.Essas funções usam o PATH variável de ambiente para localizar o arquivo para executar.

A partir de Visual C++ 2005, o _execlpe funções validar seus parâmetros. Se qualquer um dos cmdname ou arg0 é um valor nulo ponteiros ou seqüência vazia, essas funções chamar o manipulador de parâmetro inválido conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções conjunto errno para EINVAL e retornar -1. Nenhum novo processo é iniciado.

Requisitos

Função

Cabeçalho necessário

Cabeçalho opcional

_execlpe

<processo.h>

<errno.h>

_wexeclpe

<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