Scanlab RTC6 PCIe Board - Eth_Convert_Ip_To_String

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
358
innovators for industry
Ctrl Command eth_convert_ip_to_string
Function Converts an IP address in big-endian byte order to the usual dotted decimal notation (for
example, “192.168.250.1”).
Call eth_convert_ip_to_string( Ip, IpString )
Parameters Ip To-be converted IP address in big-endian byte order.
As an unsigned 32-bit value.
IpString Converted IP address. As a pointer (in C and C++ data type ULONG_PTR,
an unsigned 32-bit value or unsigned 64-bit value) to an array of 4
unsigned 32-bit values, where the converted IP address as a string in usual
dotted decimal notation can be found (synonymously to a character array
of length 16, low byte first, with concluding \0).
Result None.
Comments • eth_convert_ip_to_string is not available as a multi-board command.
• For storage of the converted IP address, the user program must provide a memory area
of 4 × 4 bytes at the address specified by IpString .
• Example: Ip = 33204416, IpString [0] = “192.”, IpString [1] = “168.”,
IpString [2] = “250.”, IpString [3] = “1\0xx”.
• The use of eth_convert_ip_to_string is useful, for example, for eth_get_static_ip.
• See also Chapter 16.5.1 ”Notes on Working with IP Addresses”, page 904.
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 606, OUT 606, RBF 611.
References eth_convert_string_to_ip, eth_get_static_ip