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 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_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