_execve, _wexecve

Artigo
06/09/2015

Carrega e executa novos processos filho.

Importante

Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

intptr_t _execve( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecve( 
   const wchar_t *cmdname,
   const wchar_t *const *argv,
   const wchar_t *const *envp 
);

Parâmetros

cmdname
Caminho do arquivo a ser executado.
argv
Matriz de ponteiros para parâmetros.
envp
Matriz de ponteiros para configurações de ambiente.

Valor de retorno

Se bem-sucedidas, essas funções não retornarão 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 excedem 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 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 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, indicando que o processo de chamada não foi alocado adequadamente.

Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.

Comentários

Cada uma dessas funções carrega e executa um novo processo, passando uma matriz de ponteiros para argumentos de linha de comando e uma matriz de ponteiros para configurações de ambiente.

_execve e _wexecve validam seus parâmetros. Se cmdname for um ponteiro nulo, ou se argv for um ponteiro nulo, ponteiro de uma matriz vazia, ou se a matriz contiver uma cadeia de caracteres vazia como primeiro argumento, essas funções chamarão o manipulador de parâmetro inválido conforme descrito em Validação do parâmetro. Se a execução puder continuar, essas funções definirão errno para EINVAL e retornarão -1. Nenhum processo é iniciado.