Compartilhar via


_execlpe, _wexeclpe

O carrega e executam novos processos filho.

Observação importanteImportante

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.

Requisitos

Função

Cabeçalho necessário

Cabeçalho opcional

_execlpe

<process.h>

<errno.h>

_wexeclpe

<process.h> ou <wchar.h>

<errno.h>

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

Exemplo

Consulte o exemplo em _exec, funções de _wexec.

Equivalência do .NET Framework

Consulte também

Referência

Processo e controle do ambiente

_exec, _wexec funções

anulação

atexit

sair, _exit

_onexit, _onexit_m

_spawn, _wspawn funções

sistema, _wsystem