_spawnvp, _wspawnvp

Статья
04/10/2013

Создает процесс и выполняет его.

Важно
Этот API нельзя использовать в приложениях, выполняемых в Среда выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /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 
);

Параметры

mode
Режим выполнения для вызова процесс.
cmdname
Путь к файлу, в который будет выполняться.
argv
Массив указателей на аргументами.Аргумент argv[0] обычно указатель на пути в реальном режиме или к названию программы в защищенном режиме и argv[1], argv[n] указатели символьным строкам форма новый список аргументов.Аргумент argv[n ] +1 должен быть указателем NULL, чтобы отметить конец списка аргументов.

Возвращаемое значение

Возвращаемое значение синхронного из _spawnvp или _wspawnvp (_P_WAIT ), указанного параметром mode нового выхода состояние процесса.Возвращаемое значение в асинхронном _spawnvp или _wspawnvp (_P_NOWAIT или _P_NOWAITO, определенные для mode) процессу дескриптор.Состояние выхода значение 0, если процесс завершил обычно.Можно задать состояние выхода в ненулевому значению, если порожданный процесс, использующий ненулевое аргумент для вызова процедуры exit.Если новый процесс явно укажите положительное состояние выхода, положительное состояние передачи показывает анормалный выход с прекращением прерывания или прерыванием.Возвращаемое значение – 1 указывает на ошибку (не запущен новый процесс).В этом случае errno имеет одно из следующих значений:

E2BIG
Список аргументов превышает 1024 байт.
EINVAL
аргумент mode является недопустимым.
ENOENT
Файл или путь не найден.
ENOEXEC
Указанный файл не исполнительн или имеет недопустимый формат исполняемого файла.
ENOMEM
Недостаточно памяти доступен для нового процесса.

Дополнительные сведения об этих и других, кодов возврата см. в разделе errno, _doserrno, _sys_errlist и _sys_nerr.

Заметки

Каждая из этих функций создает новый процесс и выполняет его и передает массив указателей на аргументы командной строки и использует переменной среды PATH, чтобы найти файл для выполнения.

Эти функции проверяют их параметрами.Если cmdname или argv указатель либо если параметр argv указывает на пустому указателю, или argv[0], является пустой строкой, то вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров.Если среда выполнения может продолжить, это функциями errno задается значение EINVAL и возвращением -1.Нет новый процесс не порождан.