_execvpe, _wexecvpe

Artigo
02/25/2013

Tanto quanto processos filho de um novos.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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
Ponteiros a matriz de parâmetros.
envp
Matriz de ponteiros para configurações de ambiente.

Valor de retorno

Se com êxito, essas funções não retornam ao processo de chamada.Um valor de retorno de – 1 indica um erro nesse caso, a variável global de errno é definido.

valor deerrno	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 um bloqueio ou compartilhar violação.
EMFILE	Arquivos demais estão abertos.(O arquivo especificado deve ser aberto para determinar se ele é executável.)
ENOENT	O arquivo ou o caminho não são encontrados.
ENOEXEC	O arquivo especificado não é executável ou tem um formato de arquivo executável inválido.
ENOMEM	Não está disponível 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ído 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 carregar e executa um novo processo, e passa uma matriz de ponteiros para argumentos de linha de comando e uma matriz de ponteiros para configurações de ambiente.Essas funções usam a variável de ambiente de PATH para localizar o arquivo para executar.

Funções de _execvpe validam seus parâmetros.Se cmdname é um ponteiro zero, ou se argv é um ponteiro zero, 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 chamam o manipulador de parâmetro inválido, como descrito em Validação de parâmetro.Se a execução é permitida continuar, este errno definir funções a EINVAL e retorne -1.Nenhum processo é iniciado.