_spawnv, _wspawnv

Articolo
03/26/2013

Crea ed esegue un nuovo processo.

Importante
Questa API non può essere utilizzata nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

intptr_t _spawnv(
   int mode,
   const char *cmdname,
   const char *const *argv 
);
intptr_t _wspawnv(
   int mode,
   const wchar_t *cmdname,
   const wchar_t *const *argv 
);

Parametri

mode
Modalità di esecuzione del processo chiamante.
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 _spawnv sincrono o da _wspawnv (_P_WAIT specificato per mode) è lo stato di uscita del nuovo processo.Il valore restituito da _spawnv asincrono o da _wspawnv (_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 chiama la routine di exit con un argomento diverso da zero.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 altri codici restituiti, vedere _doserrno, errno, _sys_errlist, e _sys_nerr.

Note

Ognuna di queste funzioni crea ed esegue un nuovo processo, passando una matrice di puntatori agli argomenti della riga di comando.

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.