DeleteRtProcess

Attempts to delete a process indicated by the handle value, and all of the process' threads and objects.

During deletion:

Borrowed resources return to the process's parent.
Interrupt levels associated with interrupt threads owned by the process are reset. Levels without associated interrupt threads are not reset.

Note: this call only attempts to delete the system objects. The deleted process will NOT be signaled so will not perform any clean up operations. Any RSLs linked to the process will also not be signaled. It is recommended to use TerminateRtProcess in preference to this call.

Note that this call will fail if the process contains a thread which currently holds a region.

BOOLEAN DeleteRtProcess(
        RTHANDLE hProcess,    // handle for a process
        DWORD dwFlags
        );

Parameters

hProcess: A handle for an RT process.
dwFlags: Reserved for future use. Zero must be passed.

Return Values

TRUE: Success.
FALSE: Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000: No exceptional conditions occurred.
E_CONTEXT: The process contains a thread which is currently holding a region.
E_EXIST: The hProcess parameter does not contain a valid handle value.
E_TYPE: The hProcess parameter does not contain a handle for a process.

Requirements

Versions	Defined in	Include	Link to
INtime 3.0	intime/rt/include/rtbase.h	rt.h	rt.lib