GetExitCodeProcess

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the termination status of the specified process.

Syntax

BOOL GetExitCodeProcess(
  HANDLE hProcess,
  LPDWORD lpExitCode
);

Parameters

• hProcess
  [in] Handle to the process.

• lpExitCode
  [out] Pointer to a 32-bit variable to receive the process termination status.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

If the specified process has not terminated, the termination status returned is STILL_ACTIVE.

The following termination statuses can be returned if the process has terminated:

• 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

Requirements

See Also

Reference

Process and Thread Functions
ExitProcess
TerminateProcess

Other Resources

WinMain