_execvpe, _wexecvpe

Artigo
06/09/2015

Carrega e processos filho das execuções novos.

Importante

Não é possível usar essa API em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

intptr_t _execvpe( 
   const char *cmdname,
   const char *const *argv,
   const char *const *envp 
);
intptr_t _wexecvpe( 
   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 exceder 32 KB.
EACCES	O arquivo especificado tem uma violação de bloqueio ou compartilhamento.
EMFILE	Muitos arquivos estão abertos. (O arquivo especificado deve ser aberto para determinar se é um 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 para executar o novo processo; a memória disponível foi danificada; um bloco ou inválido existir, que indica que o processo de chamada não esteve atribuída corretamente.

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

Comentários

Cada uma dessas funções carrega e executa um novo processo, e passe uma matriz de ponteiros para os argumentos de linha de comando e uma matriz de ponteiros para as configurações de ambiente. Essas funções usam a variável de ambiente PATH para localizar o arquivo a ser executado.

As funções de _execvpe validam seus parâmetros. Se cmdname for um ponteiro nulo, ou se argv for um ponteiro nulo, um ponteiro para uma matriz vazia, ou um ponteiro para uma matriz que contém uma cadeia de caracteres vazia como o primeiro argumento, essas funções invoca o manipulador inválido do parâmetro, 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.