_execvp, _wexecvp

Artigo
02/25/2013

O carrega e executam novos processos filho.

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 _execvp( const char *cmdname, const char *const *argv ); intptr_t _wexecvp( const wchar_t *cmdname, const wchar_t *const *argv );

Parâmetros

cmdname
Caminho do arquivo a ser executado.
argv
Ponteiros a matriz de parâmetros.

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.
EINVAL	Parâmetro inválido.
EMFILE	Muitos arquivos abertos (o arquivo especificado deve ser aberto para determinar se ele é executável.)
ENOENT	O arquivo ou o 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 está disponível memória suficiente para executar o novo processo; a memória disponível foi danificada; um bloco ou inválido existir, indicando 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 _doserrno, errno, _sys_errlist, e _sys_nerr.

Comentários

Cada uma dessas funções carregar e executa um novo processo, passando uma matriz de ponteiros para argumentos de linha de comando e usando a variável de ambiente PATH para localizar o arquivo para executar.

Funções de _execvp validam seus parâmetros.Se cmdname é um ponteiro zero, ou argv é um ponteiro zero, ponteiro para uma matriz vazia, ou se a matriz contém uma cadeia de caracteres vazia como o primeiro argumento, essas funções chamam o manipulador inválido de parâmetros 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.