Terminates the current process (and thereby all threads in it) and specifies the exit code. Any threads waiting for the process wake up.

VOID ExitProcess(
    UINT uExitCode
);

VOID RtExitProcess(
    UINT uExitCode
);

Parameters

uExitCode

Specifies the exit code for the process and for all threads terminated as a result of this function.

To retrieve the process's exit value, use GetExitCodeProcess. To retrieve a thread's exit value, use GetExitCodeThread.

Remarks

This function is the preferred method of ending a process because it provides a clean process shutdown. This includes calling the entry-point function of all attached RSLs with a value indicating that the process is detaching from the RSL.

After all attached RSLs execute any process termination code, this function terminates the current process.

Terminating a process causes these actions:

• All object handles opened by the process close.
• All threads in the process terminate execution.
• The state of the process object becomes signaled, satisfying threads waiting for the process to terminate.
• The states of all process threads become signaled, satisfying threads waiting for the threads to terminate.
• The termination status of the process changes from STILL_ACTIVE to the process exit value.

Terminating a process does not necessarily remove the process object from the OS. A process object is deleted when the last handle to the process closes.

Return Values

None.

Requirements

Notes

• In the iwin32 API, ExitProcess and RtExitProcess are synonyms.
• This function operates in the real-time portion of your application.

See Also

CreateThread, ExitThread, GetExitCodeProcess, GetExitCodeThread, OpenProcess, RtCreateProcess, TerminateProcess, iwin32 API, iwin32 Overview