RtfwStartTCPIPStack

RtfwStartTCPIPStack starts the RT-TCP/IP Stack.

Syntax

bool RtfwStartTCPIPStack(
    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_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_STARTSTOP_LOCK_FAILURE Failed to obtain the lock to serialize starting/stopping the RTX64 Subsystem.
RT_ERROR_RESTART_NETWORK The Network Abstraction Layer (NAL) needs to be restarted.
RT_ERROR_TCPIP_NOT_STOPPED The RT-TCP/IP Stack is not stopped, but an operation was attempted that requires it to be stopped.

Remarks

If the Stack is already running, this function fails and sets the last error value to RT_ERROR_NETWORK_NOT_STOPPED.

Requirements

Minimum Required Version RTX64 4.0
Header RtfwAPI.h
Library RtfwAPI.lib

See Also:

RtfwStopTCPIPStack

RtfwGetNALStatus

RtfwGetTCPIPStatus

RtfwGetTCPIPClientProcessIDs

RtfwGetNetworkInterfacesStatus

RtfwGetSubsystemStatus

RtfwStopSubsystem