TerminateProcess (Windows CE 5.0)
This function terminates the specified process and all of its threads.
BOOLTerminateProcess(HANDLEhProcess, DWORDuExitCode);
Parameters
hProcess
[in] Handle to the process to terminate.uExitCode
[in] Specifies the exit code for the process and for all threads terminated as a result of this call.To retrieve the process's exit value, use the GetExitCodeProcess function.
To retrieve a thread's exit value, use the GetExitCodeThread function.
Return Values
Nonzero indicates success.
Zero indicates failure.
To get extended error information, call GetLastError.
Remarks
This function is used to unconditionally cause a process to exit.
Use this function only in extreme circumstances.
This function causes all threads within a process to terminate, causes a process to exit, and notifies each DLL that the process is terminating.
The following list shows what occurs when a process is terminated:
- All object handles opened by the process are closed.
- All threads in the process terminate their execution.
- The state of the process object becomes signaled, satisfying threads waiting for the process to terminate.
- The states of all threads of the process become signaled, satisfying threads 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 system.
A process object is deleted when the last handle to the process is closed.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Winbase.h.
Link Library: Coredll.lib.
See Also
GetExitCodeProcess | GetExitCodeThread
Send Feedback on this topic to the authors