_spawnvp, _wspawnvp

Articolo
03/26/2013

Crea un processo e lo esegue.

Importante
Questa API non può essere utilizzato nelle applicazioni eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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 
);

Parametri

mode
Modalità di esecuzione per chiamare il processo.
cmdname
Percorso del file da eseguire.
argv
Matrice di puntatori agli argomenti.L'argomento argv[0] è in genere un puntatore a un percorso in modalità attivo o al nome del programma in modalità protetta e argv[1] con argv[] ènpuntatori alle stringhe di caratteri che costituiscono il nuovo elenco di argomenti.L'argomento argv[]n +1 deve essere un puntatore di NULL per contrassegnare la fine dell'elenco di argomenti.

Valore restituito

Il valore restituito da _spawnvp sincrono o da _wspawnvp (_P_WAIT specificato per mode) è lo stato di uscita del nuovo processo.Il valore restituito da _spawnvp asincrono o da _wspawnvp (_P_NOWAIT o _P_NOWAITO specificato per mode) è un handle aprirlo.Lo stato di uscita è 0 se il processo termine generale.È possibile impostare lo stato di uscita un valore diverso da zero se il processo generato in particolare utilizza un argomento diverso da zero per chiamare la routine di exit.Se il nuovo processo in modo esplicito impostando lo stato di uscita positivo, lo stato di uscita positivo indica l'uscita anomala con un'interruzione o un'interruzione.Restituito un valore pari a 1 indica un errore (il nuovo processo non avviata).In questo caso, errno è impostato su uno dei seguenti valori:

E2BIG
L'elenco di argomenti supera i 1024 byte.
EINVAL
l'argomento dimode non è valido.
ENOENT
Il file o il percorso non viene trovato.
ENOEXEC
Il file specificato non è eseguibile o di formato di file eseguibile non valido.
ENOMEM
Memoria insufficiente è disponibile per eseguire il nuovo processo.

Per ulteriori informazioni su questi e su altri, codici restituiti, vedere errno, _doserrno, _sys_errlist e _sys_nerr.

Note

Ognuna di queste funzioni crea un nuovo processo e lo esegue e passa una matrice di puntatori agli argomenti della riga di comando e utilizza la variabile di ambiente PATH per individuare il file da eseguire.

Queste funzioni convalidano i parametri.Se cmdname o argv è un puntatore null, o se i punti di argv al puntatore null, o argv[0] è una stringa vuota, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, questo funzioni errno impostato tornare a EINVALe -1.Nessun nuovo processo viene generato.