CIcmpClient::SetHostName Method  
 
INT SetHostName(
  HCLIENT hClient,  
  LPCTSTR lpszHostName  
);

The SetHostName method specifies the name of the host to receive an ICMP echo datagram. If the name specifies a new host, the current client statistics are reset.

Parameters

hClient
A handle to the client session.
lpszHostName
A pointer to a string which specifies the name, or IP address in dot-notation, of the remote host.

Return Value

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

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
Unicode: Implemented as Unicode and ANSI versions

See Also

GetHostAddress, GetHostName, SetHostAddress