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

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

During deletion:

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