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:

RtfwStopNetwork

RTFW_SUBSYSTEM_STATUS

RtfwGetNetworkStatus

RtfwGetSubsystemStatus

RtfwStopSubsystem