IcmpSendEcho This function sends an Internet Control Message Protocol (ICMP) echo request, and returns one or more replies.
VB4-32,5,6
Private Declare Function IcmpSendEcho Lib "ICMP" (ByVal IcmpHandle As Long, ByVal DestAddress As Long, ByVal RequestData As String, ByVal RequestSize As Integer, RequestOptns As IP_OPTION_INFORMATION, ReplyBuffer As IP_ECHO_REPLY, ByVal ReplySize As Long, ByVal TimeOut As Long) As Boolean |
Operating Systems Supported |
Requires Windows Sockets 2.0 |
- IcmpHandle
[in] ICMP handle opened by IcmpCreateFile.
- DestinationAddress
[in] Specifies the destination of the echo request.
- RequestData
[in] Buffer that contains the data to be sent in the request.
- RequestSize
[in] Number of bytes in the RequestData buffer.
- RequestOptions
[in] Pointer to the IP header options for the request; may be NULL.
- ReplyBuffer
[out] Buffer to hold any replies to the request. When the function returns, the buffer will contain one or more ICMP_ECHO_REPLY structures, followed by options and data.
- ReplySize
[out] Size, in bytes, of the reply buffer. The buffer must be large enough to accommodate at least one ICMP_ECHO_REPLY structure plus eight additional bytes (the size of an ICMP error message).
- Timeout
[in] Time, in milliseconds, to wait for replies. |
The number of replies received and stored in the reply buffer indicates success. Zero indicates failure. Extended error information is available through GetLastError. |
|