Jump to main content

##

# 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

Parameters | Description
--- | ---
hUDP | the UDP socket
addType | Type of address: IPv4/IPv6
remoteAddress | pointer to an address to use