_spawnvp, _wspawnvp

Artigo
02/25/2013

Cria um processo e executá-lo.

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 _spawnvp( int mode, const char *cmdname, const char *const *argv ); intptr_t _wspawnvp( int mode, const wchar_t *cmdname, const wchar_t *const *argv );

Parâmetros

mode
Modo de execução para chamar o processo.
cmdname
Caminho do arquivo a ser executado.
argv
Matriz de ponteiros para argumentos.O argumento argv0 é geralmente [] um ponteiro para um caminho no modo ou o nome real de programa em modo protegido, e argv1 com argv[] []né ponteiros para cadeias de caracteres que formam a nova lista de argumentos.O argumento argv[]n + deve ser um ponteiro de NULL para marcar o fim da lista de argumentos.

Valor de retorno

O valor de retorno de _spawnvp síncrono ou _wspawnvp (_P_WAIT especificado para mode) é o status de saída do novo processo.O valor de retorno de _spawnvp assíncrono ou de _wspawnvp (_P_NOWAIT ou _P_NOWAITO especificado para mode) é o identificador do processo.O status de saída é 0 se o processo finalizou normalmente.Você pode definir o status de saída para um valor diferente de zero se o processo desovado especificamente usa um argumento diferente de zero para chamar a rotina de exit .Se o novo processo não definiu explicitamente um status de saída positivo, um status de saída positivo indica uma saída anormal com um abort uma ou interrupção.Um valor de retorno de – 1 indica um erro (o novo processo não é iniciado.)Nesse caso, errno é definida como um dos seguintes valores:

E2BIG
A lista de argumento excede 1024 bytes.
EINVAL
o argumento demode é inválido.
ENOENT
Arquivo ou o caminho não são encontrados.
ENOEXEC
O arquivo especificado não é executável ou tem o formato de arquivo executável inválido.
ENOMEM
Não está disponível memória suficiente para executar o novo processo.

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

Comentários

Cada uma dessas funções cria um novo processo e executá-lo, e passe uma matriz de ponteiros para argumentos de linha de comando e use a variável de ambiente de PATH para localizar o arquivo para executar.

Essas funções validam seus parâmetros.Se cmdname ou argv são um ponteiro zero, ou se os pontos de argv ao ponteiro zero, ou argv[0] é uma cadeia de caracteres vazia, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, este funções errno definido retorno a EINVAL, e -1.Nenhum novo processo é desovado.