RtfwStopSubsystemForce

RtfwStopSubsystemForce forces the RTX64 Subsystem to stop, even if RTSS processes or Windows processes linked to RTX64 are still running.

Syntax

bool RtfwStopSubsystemForce(
);

Parameters

This function has no parameters.

Return Value

The function returns true if it succeeds. Otherwise, it returns false. Call GetLastError for additional error information.

Possible error codes:

Error Code	Meaning
RT_ERROR_SUBSYSTEM_NOT_STARTED	The RTX64 Subsystem is not started.
RT_ERROR_SUBSYSTEM_STARTSTOP_LOCK_FAILURE	Failed to obtain the lock to serialize starting/stopping the RTX64 Subsystem.
RT_ERROR_TIMEOUT_STOPPING_SUBSYSTEM	A timeout occurred waiting for the Subsystem to shut down.

Remarks

IMPORTANT! When this API is called, no other threads in the process can be executing a call to any function in RTAPI.DLL, otherwise they will malfunction.

IMPORTANT! If the function returns error RT_ERROR_TIMEOUT_STOPPING_SUBSYSTEM, the Subsystem will likely be left in an error state as parts of the Subsystem shut down. This is most likely to occur if there are real-time applications running that have shutdown handlers attached, and whose shutdown handler threads may take more than 60 seconds to finish executing. While in this state, additional calls to this function can be made, but they will continue to fail with the same error if the shutdown handler threads are still running. If this condition persists longer than expected, the only recovery option is a full Windows restart.

See Also:

• RTFW_COMPONENT_STATUS
• RtfwGetSubsystemStatus
• RtfwStartSubsystem
• RtfwStopSubsystem
• RtfwStartTCPIPStack
• RtfwStopTCPIPStack