 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The ExitProcessfunction ends a process and all of its threads.
VOID ExitProcess( UINT uExitCode );
Parameters
- uExitCode
- [in] Specifies the exit code for the process and for all
threads that are terminated as a result of this call. Use the
GetExitCodeProcessfunction to retrieve the process's exit
value. Use the
GetExitCodeThreadfunction to retrieve a thread's exit value.
Return Values
None.
Remarks
ExitProcessis the preferred method of ending a process. This function provides a clean process shutdown. This includes calling the entry-point function of all attached dynamic-link libraries (DLLs) with a value indicating that the process is detaching from the DLL. If a process terminates by calling TerminateProcess, the DLLs that the process is attached to are not notified of the process termination.
After all attached DLLs have executed any process termination value, this function terminates the current process.
Terminating a process causes the following:
- All of the object handles opened by the process are closed.
- All of the threads in the process terminate their execution.
- The state of the process object becomes signaled, satisfying any threads that had been waiting for the process to terminate.
- The states of all threads of the process become signaled, satisfying any threads that had been waiting for the threads to terminate.
- The termination status of the process changes from STILL_ACTIVE
to the exit value of the process.
Terminating a process does not necessarily remove the process object from the operating system. A process object is deleted when the last handle to the process is closed.
Any process that is started as a result of a call by CreateProcessis run serially with the ExitProcess, ExitThread, and CreateThreadfunctions; that is, within the parent process, only one of these events can happen in an address space at a time. This means the following restrictions hold:
- During process startup and DLL initialization routines, new threads can be created, but they do not begin execution until DLL initialization is done for the process.
- Only one thread in a process can be in a DLL initialization or detach routine at a time.
- If any process is in its DLL initialization or detach routine,
ExitProcessdoes not return.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 2.0 and later mkfuncs.h Coredll.lib, See Also
CreateProcess, CreateThread, ExitThread, GetExitCodeProcess, GetExitCodeThread, OpenProcess, TerminateProcess