RtGetExitCodeProcess

RtGetExitCodeProcess retrieves the termination status of the specified process.

Syntax

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

Parameters

[in] hProcess

A handle to the process. The handle must have PROCESS_QUERY_INFORMATION access.

[out] lpExitCode

A pointer to a 64-bit variable to receive the process termination status.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. Call GetLastError to obtain an error code.

Remarks

If the specified process has not terminated, the termination status returned is STILL_ACTIVE. If the process has terminated, the termination status returned may be one of the following values:

• The exit value specified in ExitProcess or RtTerminateProcess.
• The return value from main or WinMain of the process.
• The exception value for an unhandled exception that caused the process to terminate.

Requirements