INtime SDK Help
ntxDeleteRtProcess
INtime SDK v7.1 > About INtime > INtime Kernel > Processes > ntxDeleteRtProcess

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

Versions Defined in Include Link to
INtime 3.1 ntx.h ntx.h ntx.lib, ntxext.lib

See Also

Process system calls, DeleteRtProcess