GetExitCodeProcess
The GetExitCodeProcess
function retrieves the termination status of the specified process.
BOOL GetExitCodeProcess(
|
HANDLE hProcess, |
// handle to the
process |
|
LPDWORD lpExitCode |
// address to
receive termination status |
|
); |
|
Parameters
hProcess
Identifies
the process.
Windows
NT: The handle must have
PROCESS_QUERY_INFORMATION access. For more information, see Process Objects.
lpExitCode
Points to a
32-bit variable to receive the process termination status.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
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:
The exit value specified in the
ExitProcess or TerminateProcess function.
The return value from the main
or WinMain function of the process.
The exception value for an
unhandled exception that caused the process to terminate.
See Also