SysSock2Connect (FUN) ¶ FUNCTION SysSock2Connect : RTS_IEC_RESULT Connect as a client to a TCP server. InOut: Scope Name Type Comment Return SysSock2Connect RTS_IEC_RESULT Runtime system error code (see CmpErrors.library). Input hSocket RTS_IEC_HANDLE Handle to the socket pSockAddr POINTER TO SOCKADDRESS Socket address of the server to connect to diSockAddrSize DINT Size of socket address structure
SysSock2Create (FUN) ¶ FUNCTION SysSock2Create : RTS_IEC_HANDLE Create a new socket and return the socket handle. By now STD or TLS sockets are available. Using a STD socket results in the default socket behavior. Note Using the TLS socket results in an IPv4 TCP socket where the TLS protocol is used. Since additional handshaking has to be done, connection establishment takes some time longer. By default, these sockets are created as nonblocking . If a blocking behavior is needed this has to be set explicitly . Be aware that blocking TLS sockets can lead to deadlock situations if the peer does not send TLS data. This is a potential security risk, typically for server implementations. An attacker can create a connection and then stop sending TLS data, resulting in a denial of service attack. This situation is avoided with nonblocking sockets. To avoid this potential risk by default TLS based sockets are created as nonblocking by default. This applies to handles created by SysSock2Create and SysSock2Accept . If this has to be changed use the SysSock2Ioctl to setup the desired behavior. InOut: Scope Name Type Comment Return SysSock2Create RTS_IEC_HANDLE A handle to the created socket or INVALID_HANDLE if something went wrong. The return is a descriptor (handle) of the new socket, which is required as input parameter by other library functions like SysSock2Bind , SysSock2Connect etc. Input pParameter POINTER TO SysSocket2_Parameter Class specific parameters. See SysSock_Parameter for details pResult POINTER TO RTS_IEC_RESULT Pointer to runtime system error code (see CmpErrors.library)
SysSock2FdInit (FUN) ¶ FUNCTION SysSock2FdInit : RTS_IEC_RESULT Add a socket to a socket set. InOut: Scope Name Type Comment Return SysSock2FdInit RTS_IEC_RESULT Runtime system error code (see CmpErrors.library). Input hSocket RTS_IEC_HANDLE Socket to add pfs REFERENCE TO SOCKET_FD_SET Socket Set
SysSock2FdIsset (FUN) ¶ FUNCTION SysSock2FdIsset : BOOL Check if a socket is inside of a set. InOut: Scope Name Type Comment Return SysSock2FdIsset BOOL TRUE if it is inside the set, FALSE if not. Input hSocket RTS_IEC_HANDLE Socket to check pfs REFERENCE TO SOCKET_FD_SET Socket Set
SysSock2FdZero (FUN) ¶ FUNCTION SysSock2FdZero : RTS_IEC_RESULT Clear a Socket set. InOut: Scope Name Type Comment Return SysSock2FdZero RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library). Input pfs REFERENCE TO SOCKET_FD_SET Socket Set
SysSock2GetOption (FUN) ¶ FUNCTION SysSock2GetOption : RTS_IEC_RESULT Set options of a specified socket. InOut: Scope Name Type Comment Return SysSock2GetOption RTS_IEC_RESULT Runtime system error code (see CmpErrors.library). Input hSocket RTS_IEC_HANDLE Handle to the socket diLevel DINT Level of the socket diOption DINT Socket option command pdiOptionValue POINTER TO BYTE Pointer to the option value pdiOptionLen POINTER TO DINT Lenght of option value
SysSockFdIsset (FUN) ¶ FUNCTION SysSockFdIsset : BOOL Check if a socket is inside of a set. InOut: Scope Name Type Comment Return SysSockFdIsset BOOL TRUE if it is inside the set, FALSE if not. Input hSocket RTS_IEC_HANDLE Socket to check pfs REFERENCE TO SOCKET_FD_SET Socket Set
SysSockFdZero (FUN) ¶ FUNCTION SysSockFdZero : RTS_IEC_RESULT Clear a Socket set. InOut: Scope Name Type Comment Return SysSockFdZero RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library). Input pfs REFERENCE TO SOCKET_FD_SET Socket Set
SysSockGetFirstAdapterInfo (FUN) ¶ FUNCTION SysSockGetFirstAdapterInfo : RTS_IEC_HANDLE Get adapter information struct of the first network adapter. Note: It may took a while until a change of the adapter configuration is reflected here. InOut: Scope Name Type Comment Return SysSockGetFirstAdapterInfo RTS_IEC_HANDLE Handle to be passed to SysSockGetNextAdapter() to retrieve the next adapter information. Input pAdapterInfo POINTER TO SOCK_ADAPTER_INFORMATION Network adapter information structure puxiAdapterInfoSize POINTER TO __UXINT Size in bytes of |SOCK_ADAPTER_INFORMATION| ; returns structure size from external implementation pResult POINTER TO RTS_IEC_RESULT Pointer to runtime system error code (see CmpErrors.library)
SysSockGetHostByName (FUN) ¶ FUNCTION SysSockGetHostByName : RTS_IEC_RESULT Get host description specified by host name. InOut: Scope Name Type Comment Return SysSockGetHostByName RTS_IEC_RESULT Runtime system error code (see CmpErrors.library). Input szHostName REFERENCE TO STRING Reference to host name pHost POINTER TO SOCK_HOSTENT Pointer to host description