RTX64 Native Framework Reference
The RTX64 Native Framework (RtfwAPI.DLL) is a native DLL that allows C/C++ applications to configure and control the RTX64 Subsystem programmatically. This interface provides similar functionality as the Managed Code Framework.
NOTE:
The configuration functions of this interface get and set configuration values that will be used on the next start of the RTX64 Subsystem. This means that if the Subsystem is running, changes may not take effect until a restart occurs. Considering this, the values you get may not match the values in use by the currently running Subsystem, since they may have already been changed after the Subsystem was started.
Recommendations for Using the RTX64 Native Framework library:
- Always call the Get version of a call to fill in structures, make your setting changes, and then call the Set version of the function.
- If the Subsystem is running and you modify a Subsystem or RT-TCP/IP Stack setting, check the GetLastError return. This will tell you if a restart of the Subsystem or RT-TCP/IP Stack is needed for the changes to take effect.
- Check for a required restart after calling any API that can change the Subsystem or network configuration. You can do this one of two ways:
- via the two custom error codes, RT_ERROR_RESTART_SUBSYSTEM and RT_ERROR_RESTART_NETWORK
- by calling RtfwRestartRequired