_execle
, _wexecle
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 _execle(
const char *cmdname,
const char *arg0,
... const char *argn,
NULL,
const char *const *envp
);
intptr_t _wexecle(
const wchar_t *cmdname,
const wchar_t *arg0,
... const wchar_t *argn,
NULL,
const char *const *envp
);
Parâmetros
cmdname
Caminho do arquivo a ser executado.
arg0
, ... argN
Lista de ponteiros para os parâmetros.
envp
Matriz de ponteiros para as configurações de ambiente.
Retornar valor
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 errno
variável global é definida.
errno valor |
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 |
Há muitos arquivos abertos. (O arquivo especificado deve ser 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 de arquivo executável inválido. |
ENOMEM |
Não há memória suficiente disponível para executar o novo processo; a memória disponível foi corrompida; ou existe um bloco inválido, o que indica que o processo de chamada não foi alocado corretamente. |
Para obter mais informações sobre esses códigos de retorno, consulte , , _sys_errlist
_doserrno
e _sys_nerr
.errno
Comentários
Cada uma dessas funções carrega e executa um novo processo e passa cada argumento de linha de comando como um parâmetro separado e passa uma matriz de ponteiros para as configurações de ambiente.
As funções _execle
validam seus parâmetros. Se cmdname
ou for um ponteiro nulo ou arg0
uma cadeia de caracteres vazia, essas funções invocarão o manipulador de parâmetros inválido, conforme descrito em Validação de parâmetro. Se a execução puder 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 |
---|---|---|
_execle |
<processo.h> | <errno.h> |
_wexecle |
<process.h> ou <wchar.h> | <errno.h> |
Para obter mais informações, consulte Compatibilidade.
Exemplo
Veja o exemplo em _exec
, _wexec
functions.
Confira também
Controle de processos e ambientes
_exec
, _wexec
funções
abort
atexit
exit
, _Exit
, _exit
_onexit
, _onexit_m
_spawn
, _wspawn
funções
system
, _wsystem
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de