GetExitCodeProcess 함수(processthreadsapi.h)

아티클
08/25/2023

지정된 프로세스의 종료 상태 검색합니다.

구문

BOOL GetExitCodeProcess(
  [in]  HANDLE  hProcess,
  [out] LPDWORD lpExitCode
);

매개 변수

[in] hProcess

프로세스에 대한 핸들입니다.

핸들에는 PROCESS_QUERY_INFORMATION 또는 PROCESS_QUERY_LIMITED_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 프로세스 보안 및 액세스 권한을 참조하세요.

Windows Server 2003 및 Windows XP: 핸들에는 PROCESS_QUERY_INFORMATION 액세스 권한이 있어야 합니다.

[out] lpExitCode

프로세스 종료 상태 받을 변수에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 즉시 반환됩니다. 프로세스가 종료되지 않고 함수가 성공하면 반환된 상태 STILL_ACTIVE(STATUS_PENDING 매크로(minwinbase.h))입니다. 프로세스가 종료되고 함수가 성공하면 반환되는 상태 다음 값 중 하나입니다.

ExitProcess 또는 TerminateProcess 함수에 지정된 종료 값입니다.
프로세스의 기본 또는 WinMain 함수의 반환 값입니다.
프로세스가 종료된 처리되지 않은 예외에 대한 예외 값입니다.

중요

GetExitCodeProcess 함수는 스레드가 종료된 후에만 애플리케이션에서 정의한 유효한 오류 코드를 반환합니다. 따라서 애플리케이션은 STILL_ACTIVE(259)을 오류 코드로 사용하면 안 됩니다(STILL_ACTIVE 는 STATUS_PENDING 매크로(minwinbase.h)). 스레드가 STILL_ACTIVE (259)를 오류 코드로 반환하는 경우 해당 값을 테스트하는 애플리케이션은 스레드가 여전히 실행 중임을 의미하는 것으로 해석하고 스레드가 종료된 후에도 스레드 완료를 계속 테스트하여 애플리케이션을 무한 루프로 전환할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	processthreadsapi.h(Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2의 Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll