TCPIP_UDP_DestinationIPAddressSet Function

C

bool TCPIP_UDP_DestinationIPAddressSet(UDP_SOCKET hUDP, IP_ADDRESS_TYPE addType, IP_MULTI_ADDRESS* remoteAddress); 

Returns

  • true - Indicates success

  • false - Indicates failure:

  • invalid socket

  • invalid socket address type

  • socket is of broadcast type

Description

  • It sets the IP destination address This allows changing the IP destination address dynamically.

Remarks

The call will fail if the socket was previously set to broadcast using the TCPIP_UDP_OptionsSet call. TCPIP_UDP_OptionsSet takes precedence. The call will fail if remoteAddress is 0. The destination IP address will not be changed.

Preconditions

UDP initialized UDP socket should have been opened with TCPIP_UDP_ServerOpen()/TCPIP_UDP_ClientOpen()(). hUDP - valid socket remoteAddress - valid address pointer

Parameters

ParametersDescription
hUDPthe UDP socket
addTypeType of address: IPv4/IPv6
remoteAddresspointer to an address to use