_spawnlpe, _wspawnlpe

아티클
04/10/2013

만들고 새 프로세스를 실행 합니다.

중요
이 API를 실행 하는 응용 프로그램에서 사용할 수 있는 Windows 런타임.자세한 내용은 /zw에 지원 되는 CRT 함수.

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 
);

매개 변수

mode
실행 모드 호출 하는 프로세스입니다.
cmdname
실행 파일의 경로입니다.
arg0, arg1, ... argn
목록 인수에 대 한 포인터입니다.arg0 인수에 대 한 포인터는 일반적으로 cmdname.인수 arg1 - argn 새 인수 목록을 형성 하는 문자열에 대 한 포인터입니다.다음 argn에 있어야는 NULL 인수 목록의 끝을 표시 하는 포인터입니다.
envp
환경 설정에 대 한 포인터의 배열입니다.

반환 값

동기 반환 값 _spawnlpe 또는 _wspawnlpe (_P_WAIT 에 지정 된 mode) 새 프로세스의 종료 상태입니다.반환 값은 비동기 _spawnlpe 또는 _wspawnlpe (_P_NOWAIT 또는 _P_NOWAITO 에 지정 된 mode) 프로세스 핸들입니다.프로세스가 정상적으로 종료 하는 경우 종료 상태 0입니다.종료 상태를 0이 아닌 값으로 설정할 수 있습니다 생성 된 프로세스 특히 0이 아닌 인수를 호출 하는 경우는 exit 루틴입니다.새 프로세스 양수 종료 상태를 명시적으로 설정 하지 않은 경우 양수 종료 상태 중단 또는 인터럽트 발생 한 비정상 종료를 나타냅니다.반환 값이-1 (새 프로세스가 시작 되지 않은) 오류를 나타냅니다.이 경우 errno 는 다음 값 중 하나로 설정 됩니다.

E2BIG
1024 바이트를 초과 하는 인수 목록입니다.
EINVAL
mode인수가 잘못 되었습니다.
ENOENT
파일 또는 경로 찾을 수 없습니다.
ENOEXEC
지정한 파일 실행 중이거나 실행 파일 형식이 잘못 되었습니다.
ENOMEM
새로운 프로세스를 실행 하는 데 사용할 수 있는 메모리가 부족 합니다.

이러한 및 다른 반환 코드에 대 한 자세한 내용은 참조 하십시오 errno, _doserrno, _sys_errlist, _sys_nerr.

설명

이러한 각 함수 및 새 프로세스 실행 각 명령줄 인수에는 별도 매개 변수로 전달 만들고 환경 설정에 대 한 포인터의 배열을 전달 합니다.이러한 함수를 사용 하는 PATH 환경 변수는 실행 파일을 찾을 수 있습니다.

이러한 함수 매개 변수의 유효성을 검사 합니다.경우 cmdname 또는 arg0 는 빈 문자열 이거나 null 포인터인 경우 잘못 된 매개 변수 처리기의 설명에 따라 호출 됩니다 매개 변수 유효성 검사.계속 실행이 허용 되 면 이러한 함수를 설정 errno 에 EINVAL,-1을 반환 합니다.새 프로세스가 생성 됩니다.