IcmpSetHostAddress Function  
 
INT WINAPI IcmpSetHostAddress(
  HCLIENT hClient,  
  DWORD dwAddress  
);

The IcmpSetHostAddress function specifies the IP address of the host to receive an ICMP echo datagram. If the address specifies a new host, the current client statistics are reset.

Parameters

hClient
A handle to the client session.
dwAddress
The IP address of the remote host as a 32-bit integer value, specified in network byte order.

Return Value

If the function succeeds, the return value is zero. If the function fails, the return value is ICMP_ERROR. To get extended error information, call IcmpGetLastError.

Remarks

To specify a remote host name or an IP address as a string in dot notation, use the IcmpSetHostName function instead.

Requirements

Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Import Library: csicmv11.lib

See Also

IcmpGetHostAddress, IcmpGetHostName, IcmpSetHostName