Deletes a real-time process.

NTXSTATUS ntxDeleteRtProcess(
    NTXHANDLE hProcess
);

Parameters

hProcess

An NTXHANDLE for the target process.

Remarks

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 only attempts to delete the system objects. The deleted process will not be signaled so it can perform any clean up operations. Any RSLs linked to the process will not be signaled.

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

Return Values

E_OK

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000

No exceptional conditions occurred.

E_EXIST

Handle was not a valid process handle.

E_TIME

The process holds a region so the request to delete it times out.

Requirements

See Also

Process system calls, DeleteRtProcess