_execlp, _wexeclp

Carrega e executa novos processos filho.

Importante

Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

intptr_t _execlp(
   const char *cmdname,
   const char *arg0,
   ... const char *argn,
   NULL
);
intptr_t _wexeclp(
   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 Retornado

Se bem-sucedidas, essas funções não retornam ao processo de chamada. Um valor de retorno de -1 indica um erro, caso em que a variável global errno é definida.

Valor 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 uma violação de compartilhamento ou de bloqueio.
EINVAL Parâmetro inválido.
EMFILE Muitos arquivos abertos (o arquivo especificado deve ser aberto para determinar se ele é executável).
ENOENT 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 disponível para executar o novo processo. A memória disponível foi corrompida ou há 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 como um parâmetro separado e usando a variável de ambiente PATH para encontrar o arquivo a ser executado.

As _execlp de dados validam seus parâmetros. Se cmdname ouarg0 for um ponteiro nulo ou uma cadeia de caracteres vazia, essas funções invocarão o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, essas funções definirão errno como EINVAL e retornarão -1. Nenhum processo novo é inicializado.

Requisitos

Função Cabeçalho necessário Cabeçalho opcional
_execlp <process.h> <errno.h>
_wexeclp <process.h> ou <wchar.h> <errno.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Consulte o exemplo nas funções _exec, _wexec.

Consulte também

Processo e controle de ambiente
_exec, _wexec funções
Abortar
atexit
exit, _Exit, _exit
_onexit, _onexit_m
_spawn, _wspawn funções
system, _wsystem