RtfwStartNetwork
RtfwStartNetwork starts the RT-TCP/IP Stack.
Syntax
bool RtfwStartNetwork( unsigned int reserved );
Parameters
reserved
This parameter must always be set to zero.
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, but an operation was attempted that requires it to be started. |
RT_ERROR_NETWORK_NOT_STOPPED | The RT-TCP/IP Stack is not stopped, but an operation was attempted that requires it to be stopped. |
RT_ERROR_NO_STACK_LICENSE | An operation was attempted that requires the RT-TCP/IP Stack to be licensed, but no stack license is available. |
RT_ERROR_NETWORK_NOT_INSTALLED | An operation was attempted that requires the RT-TCP/IP Stack to be installed, but it is not installed. |
RT_ERROR_NETWORK_STARTSTOP_LOCK_FAILURE | Failed to obtain the lock to serialize starting/stopping the RTX64 Subsystem. |
Remarks
If the Stack is already running, this function fails and sets the last error value to RT_ERROR_NETWORK_NOT_STOPPED.
If the Subsystem is not started, this function fails and sets the last error value to RT_ERROR_SUBSYSTEM_NOT_STARTED.
Requirements
Minimum Required Version | RTX64 3.4 |
Header | RtfwAPI.h |
Library | RtfwAPI.lib |
See Also: