_spawnlpe, _wspawnlpe

Cria e executa um novo processo.

Sintaxe

intptr_t _spawnlpe(
   int mode,
   const char *cmdname,
   const char *arg0,
   const char *arg1,
   ... const char *argn,
   NULL,
   const char *const *envp
);
intptr_t _wspawnlpe(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *arg0,
   const wchar_t *arg1,
   ... const wchar_t *argn,
   NULL,
   const wchar_t *const *envp
);

Parâmetros

mode
Modo de execução do processo de chamada.

cmdname
Caminho do arquivo a ser executado.

arg0, arg1, ... argN
Lista de ponteiros para os argumentos. O argumento arg0 costuma ser um ponteiro para cmdname. Os argumentos de arg1 a argN são ponteiros para as cadeias de caracteres que formam a nova lista de argumentos. Após argN, deve haver um ponteiro NULL para marcar o fim da lista de argumentos.

envp
Matriz de ponteiros para as configurações de ambiente.

Valor retornado

O valor retornado de uma _spawnlpe ou _wspawnlpe síncrona (_P_WAIT especificado para mode) é o status de saída do novo processo. O valor retornado de uma _spawnlpe ou _wspawnlpe assíncrona (_P_NOWAIT ou _P_NOWAITO especificado para mode) é o identificador do processo. O status de saída é 0 se o processo foi encerrado normalmente. Você poderá definir o status de saída para um valor diferente de zero se o processo gerado usar especificamente um argumento diferente de zero para chamar a rotina exit. Se o novo processo não tiver definido explicitamente um status de saída positivo, um status de saída positivo indicará uma saída anormal causada por uma anulação ou interrupção. Um valor retornado de -1 indica um erro (o novo processo não foi iniciado). Nesse caso, o parâmetro errno é definido com um dos valores a seguir.

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

Comentários

Cada uma dessas funções cria e executa um novo processo e passa cada argumento de linha de comando como um parâmetro separado e passa 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.

Essas funções validam seus parâmetros. Se or cmdname arg0 for uma cadeia de caracteres vazia ou um ponteiro nulo, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essas funções definirão errno como EINVAL e retornarão -1. Nenhum processo novo é gerado.

Requisitos

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Veja o exemplo em _spawn, _wspawn funções.

Confira também

Controle de processo e ambiente
_spawn, _wspawn funções
abort
atexit
_exec, _wexec funções
exit, _Exit, _exit
_flushall
_getmbcp
_onexit, _onexit_m
_setmbcp
system, _wsystem