ST_AmsRouteEntryEx

This data type contains information on the configuration of a remote TwinCAT connection.

TYPE ST_AmsRouteEntryEx :
STRUCT
    sName         : STRING(MAX_ROUTE_NAME_LEN);
    sNetID        : T_AmsNetId;
    sAddress      : STRING(MAX_ROUTE_ADDR_LEN);
    sVirtualNetID : T_AmsNetId;
    eTransport    : E_RouteTransportType;
    tTimeout      : TIME;
    dwFlags       : DWORD;
END_STRUCT
END_TYPE

Value

Meaning

sName

Symbolic name of the remote TwinCAT system. This name can be chosen freely. The maximum string length is limited through a constant (default: 31 characters).

sNetID

Network address of the remote TwinCAT system (type: T_AmsNetID).

sAddress

System address in relation to the respective transport layer. If TCP/IP is used as the transport layer the IP address is specified here. The maximum string length is limited through a constant (default: 79 characters).

sVirtualNetID

Virtual network address (type: T_AmsNetID) See also the description of the AmsNAT functionality.

eTransport

The transport layer with which AMS messages are transported (type: E_RouteTransportType). Only the TCP/IP transport layer is currently supported.

tTimeout

Timeout time. (currently reserved and not used).

dwFlags

Additional options (currently reserved and not used).

Requirements

Development environment

Target platform

PLC libraries to be integrated (category group)

TwinCAT v3.1.4024

PC or CX (x86, x64, Arm®)

Tc2_Utilities (system)
>= v3.3.41.0