_execvpe, _wexecvpe

Artigo
08/25/2010

Carrega e executa novos processos filho.

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 para executar.
argv
Matriz de ponteiros para os parâmetros.
envp
Matriz de ponteiros para as configurações de ambiente.

Valor de retorno

Se for bem-sucedido, essas funções não retornam ao processo de chamada.Um valor retornado de – 1 indica um erro, que nesse caso o errno variável global é definida.

errno valor	Descrição
E2BIG	O espaço necessário para os argumentos e configurações de ambiente excede 32 KB.
EACCES	O arquivo especificado tem uma violação de bloqueio ou compartilhamento.
EMFILE	Muitos arquivos abertos (o arquivo especificado deve ser em aberto para determinar se é executável).
ENOENT	O 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 está disponível para executar o novo processo; corrompeu a memória disponível; ou existe 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 uma matriz de ponteiros para argumentos de linha de comando e uma matriz de ponteiros para as configurações de ambiente.Essas funções usam o PATH variável de ambiente para localizar o arquivo para executar.

In Visual C++ 2005, o _execvpe funções validar seus parâmetros. Se o cmdname é um ponteiro nulo, ou se argv é um ponteiro nulo, o ponteiro para uma matriz vazia, ou se a matriz contém uma seqüência vazia sistema autônomo o primeiro argumento, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções conjunto errno para EINVAL e retornar -1. Nenhum processo é iniciado.