IcmpSendEcho Function  
 
INT WINAPI IcmpSendEcho(
  HCLIENT hClient  
);

The IcmpSendEcho function sends an ICMP echo datagram to the remote host.

Parameters

hClient
A handle to the client session.

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

For asynchronous client sessions, this function returns immediately. Otherwise, the client enters a blocking state and waits for a reply from the remote host. The function returns when a reply has been received, or the operation times-out.

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

IcmpEcho, IcmpGetSendCount, IcmpRecvEcho, IcmpSetSequenceId, IcmpSetTimeToLive, IcmpTraceRoute