自制Ping(1) IcmpSendEcho2Ex function

最新推荐文章于 2022-04-22 18:04:39 发布
最新推荐文章于 2022-04-22 18:04:39 发布
阅读量4.2k 收藏 2
点赞数 2
分类专栏： C/C++ 文章标签： C++ IcmpSendEcho2Ex ICMP ping 中文

IcmpSendEcho2Ex function

IcmpSendEcho2Ex 发送IPv4 ICMP请求, 立即返回(如果Event 或ApcRoutine 非空)或等超时后返回. ReplyBuffer中存放ICMP响应(如果有).

语法

DWORD WINAPI IcmpSendEcho2Ex(
 _In_      HANDLE IcmpHandle,
 _In_opt_  HANDLE Event,
 _In_opt_  PIO_APC_ROUTINE ApcRoutine,
 _In_opt_  PVOID ApcContext,
 _In_      IPAddr SourceAddress,
 _In_      IPAddr DestinationAddress,
 _In_      LPVOID RequestData,
 _In_      WORD RequestSize,
 _In_opt_  PIP_OPTION_INFORMATION RequestOptions,
 _Out_     LPVOID ReplyBuffer,
 _In_      DWORD ReplySize,
 _In_      DWORD Timeout
);

参数

IcmpHandle [in]

通过ICMPCreateFile打开的handle

Event [in, optional]

每当收到一个ICMP响应, 就会触发一个event. 如果要指定该参数, 需要一个有效的事件(event). 用CreateEvent 或 CreateEventEx创建一个事件.

更多关于事件的说明, 参见 Event Objects.

ApcRoutine [in, optional]

异步处理函数, 当工作线程处在一个可报警的线程里并且收到ICMP, 则会执行该过程.

必须定义PIO_APC_ROUTINE_DEFINED, 以强制该参数的数据类型为PIO_APC_ROUTINE, 而非FARPROC.

ApcContext [in, optional]

传入ApcRoutine的参数. (每当收到一条ICMP或发生错误)

SourceAddress [in]

发出请求的IPv4(源)地址. IPAddr 类型.

DestinationAddress [in]

请求的IPv4目的地址. IPAddr 类型.

RequestData [in]

要发送的请求中包含的数据.

RequestSize [in]

RequestData (请求数据)的大小, 单位bytes.

RequestOptions [in, optional]

请求的IP头选项, 类型为 IP_OPTION_INFORMATION . 在64位平台上, 该参数类型为 IP_OPTION_INFORMATION32.

如果不需要指定指定IP头选项, 置为NULL.

ReplyBuffer [out]

用来缓存响应数据. 收到返回时, 该值为相应请求信息的一个ICMP_ECHO_REPLY 数组后跟选项和数据. 缓存大小不小于一个ICMP_ECHO_REPLY结构大小加RequestSize 大小. 64位平台对应的是ICMP_ECHO_REPLY32.

缓存大小应至少8个字节(ICMP错误信息大小)加IO_STATUS_BLOCK的大小.

ReplySize [in]

响应缓存分配的大小(字节). 缓存大小应至少为一个ICMP_ECHO_REPLY结构大小加RequestSize大小. 64位平台对应ICMP_ECHO_REPLY32.

缓存大小也应至少为8字节加IO_STATUS_BLOCK结构大小.

Timeout [in]

等待响应返回的最大时间(超时), 单位毫秒.

返回值

当以同步方式调用时, IcmpSendEcho2Ex 会返回ReplyBuffer中收到和存储的响应数. 如果返回值为0, 调用GetLastError获得具体错误信息.

当以异步方式调用时, IcmpSendEcho2Ex 会返回ERROR_IO_PENDING表示正在处理, 结果可以稍后通过事件通知或者ApcRoutine回调获取. 如果返回值为0, 调用GetLastError获得具体错误信息.

如果函数出错, GetLastError获得的错误号可以是下列值:

Return code

Description

ERROR_INVALID_PARAMETER

无效参数. 当IcmpHandle是一个无效handle或ReplySize的值小于ICMP_ECHO_REPLY或ICMP_ECHO_REPLY32时会返回该错误.

ERROR_IO_PENDING

异步处理正在进行中. 调用IcmpSendEcho2Ex异步模式成功时会返回该值, 不是错误.

ERROR_NOT_ENOUGH_MEMORY

内存不足

ERROR_NOT_SUPPORTED

不支持该请求. 如果本地计算机没有IPv4协议栈将返回该错误.

IP_BUF_TOO_SMALL

ReplySize指定的太小.

Other

使用FormatMessage 获得错误信息文本.

 

备注

IcmpSendEcho2Ex在Win Ser 2008及以上操作系统中可用.

IcmpSendEcho2Ex是IcmpSendEcho2的增强版, 允许用户在请求时指定IPv4源地址. IcmpSendEcho2Ex在计算机有多个网络接口时非常有用.

如果ApcRoutine或Event参数值为NULL时, IcmpSendEcho2Ex将进行同步处理, 等待指定的超时后返回数据, 返回值为含接收并存储在ReplyBuffer的响应数. 如果返回值为0, 调用GetLastError获取更多信息.

当指定了ApcRoutine或Event参数时, IcmpSendEcho2Ex将进行异步处理. ReplyBuffer和ReplySize参数需要接收响应. ICMP响应数据被拷贝进ReplyBuffer, 同时应用程序被通知(若指定了Event参数)或回调函数被调用(若指定了ApcRoutine参数).

应用程序必须使用IcmpParseReplies解析响应数据ReplyBuffer.

如果指定了Event参数, IcmpSendEcho2Ex会进行异步处理. 每当接收到一个ICMP响应时Event便会被通知. 使用CreateEvent创建event对象.

如果指定了ApcRoutine参数, IcmpSendEcho2Ex会进行同步处理. ApcRoutine应指向一个用户自定义的回调函数. 每收到一条ICMP响应ApcRoutine回调函数便会被执行一次. 回调序列化执行的.

如果Event和ApcRoutine都指定了, 会使用Event, 忽略ApcRoutine.

任何异步调用IcmpSendEcho2Ex使用ApcRoutine回调的应用程序, 都必须define PIO_APC_ROUTINE_DEFINED, 来强制ApcRoutine数据类型为PIO_APC_ROUTINE而不是FARPROC.

Note  PIO_APC_ROUTINE_DEFINED must bedefined before the Icmpapi.h header file is included.

注意   PIO_APC_ROUTINE_DEFINED必须定义在Icmpapi.h之前.

 

回调函数ApcRoutine必须定以为如下格式:

typedef
VOID WINAPI
(*PIO_APC_ROUTINE) (
   IN PVOID ApcContext,
   IN PIO_STATUS_BLOCK IoStatusBlock,
   IN ULONG Reserved
   );

传入回调函数的参数:

Parameter

Description

IN PVOID ApcContext

通过IcmpSendEcho2Ex的参数ApcContext传入的外部参数, 用于应用程序标识出正在响应的是哪个请求.

IN PIO_STATUS_BLOCK IoStatusBlock

指向IO_STATUS_BLOCK的指针. 包含了关于这次操作的最终完成状态信息. 结构IO_STATUS_BLOCK中的成员Information是返回的响应实际接收的字节数.

IO_STATUS_BLOCK在头文件Wdm.h中定义.

IN ULONG Reserved

预留.

 

回调函数必须和调用的IcmpSendEcho2Ex在同一个进程中实现. 如果回调函数在分离的DLL中, 那么该DLL应该在调用IcmpSendEcho2Ex之前加载.

对于IPv6, 使用Icmp6CreateFile, Icmp6SendEcho2, 和Icmp6ParseReplies.

 

注意  头文件Iphlpapi.h必须在Icmpapi.h之前.

要求

Minimum supported client

Windows Vista with SP1 [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Icmpapi.h

Library

Iphlpapi.lib

DLL

Iphlpapi.dll

 

BrillianceRen
关注
  • 2
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
IcmpSendEcho2Ex_Demo
01-23
IcmpSendEcho2Ex Demo, 演示了IcmpSendEcho2Ex同步模式实现ping
关于IcmpSendEcho2的使用和回调问题
doujianyoutiao的博客
02-17 971
IcmpSendEcho2的使用和回调问题
自制Ping(3) IcmpSendEcho2Ex Demo
安静的自娱自乐
01-22 2112
IP Helper 可能需要WDK支持, 我本机装了WDK, 没试过不用会怎样. 由于IcmpSendEcho2Ex()回调的形式似乎与我的WDK有所冲突, 所以这里只演示阻塞模式. Event应该不受影响. Demo下载地址:   主要代码: void CPingTest1Dlg::OnBnClickedBtnPing() { // TODO: 在此添加控件通知处理程序代码 Upd
IcmpSendEcho 实现 ping
zgl7903的专栏
11-30 2091
  #include <Winsock2.h> #pragma comment(lib, "Ws2_32.lib") #include <icmpapi.h> #pragma comment(lib, "Iphlpapi.lib") // Initialize Winsock struct _tagWinSockInit_t { _tagWinSockInit_...
基于ICMP的Ping IPV6化 (IPV4&IPV6)
11-16 2009
最近在做一个有关网络编程的项目，本来对网络方面的知识没有很深的了解，在开发过程中遇到了很多的困难，最终一步一个脚印，也算是守的云开见月明。在这个开个贴记录下点点滴滴，以后再补充，为自己也为他人今后参考之用。以下是针对IPV4、IPV6的Ping程序，不多说先贴上核心代码（loadRunner部分的代码已经注掉）。 BOOL CICMPPing::Ping(std::string&
IPHLPAPI 的其它函数(1)
07-10 790
IPHLPAPI 的其它函数 IPHLPAPI还有以下的函数，这里给出C语言的函数原型和参数说明，具体说明详见MSDN2003。1、GetAdapterIndex：从名称获得一个适配器的序号DWORD GetAdapterIndex( LPWSTR AdapterName, PULONG IfIndex);       AdapterName：[输入] 指定了适配器名称的Unicode
易语言Ping网络IP地址
08-19
易语言Ping网络IP地址源码系统结构:网络_PING网络延迟时间,Ping返回状态,GetEnvironmentVar,IcmpSendEcho,IcmpCreateFile,IcmpCloseHandle,Len_ICMP,网络通讯到网络地址_,设置时钟_,销毁时钟_,取环境变量值_
API的Ping代码.rar
04-04
例如，它可能会使用`WinAPI`函数`SendARP`或`IcmpSendEcho`来发送和接收ICMP数据包，以执行ping操作。 2. ICMP协议：Internet Control Message Protocol（互联网控制消息协议）是TCP/IP协议族的一部分，用于传输...
易语言能的ping更新
08-20
能的ping更新系统结构:通信测试_,IcmpCreateFile,IcmpCloseHandle,IcmpSendEcho,WSAGetLastError,WSAStartup,WSACleanup,gethostname,gethostbyname,GetHost,GetVaradd,GetAddr,inet_addr,GetTypeSize,inet_ntoa,...
API实现ping测试源码通信测试_API测试
07-17
通信测试_,IcmpCreateFile,IcmpCloseHandle,IcmpSendEcho,WSAGetLastError,WSAStartup,WSACleanup,gethostname,gethostbyname,GetHost,GetVaradd,GetAddr,inet_addr,GetTypeSize,inet_ntoa,GetTickCount,QueryPerformanceFrequency,QueryPerformanceCounter,P
钢铁咆哮2和EX 乱码解决软件
01-01
微软推出的多语言支持工具，可以让非Unicode的软件在Windows XP/2003上运行，即可以同时执行简繁体日文等软件。
ping功能的实现原理
xiejianjun417的专栏
06-04 3375
1.Windows下ping实现 Windows平台实现ping功能，需要涉及到两个动态库Icmp.dll和Iphlpapi.dll。 根据msdn的说明： “The IcmpParseReplies function is exported from the Icmp.dll on Windows 2000. The IcmpParseReplies fun
BCB解析ICMPV6_ECHO_REPLY
fxismonk的专栏
04-28 1608
做IPv6 Ping功能，用到Icmp6SendEcho2和Icmp6ParseReplies。获得ICMPV6_ECHO_REPLY的结构后，取地址，结果不对。 发现是因为地址对齐引起。 ICMPV6_ECHO_REPLY的头文件定义如下： #include typedef struct _IPV6_ADDRESS_EX {     USHORT sin6_port;
windowsAPI发送ICMP包
river
12-28 1185
#include <winsock2.h> #include <iphlpapi.h> #include <icmpapi.h> #include <stdio.h>#pragma comment(lib, "iphlpapi.lib") #pragma comment(lib, "ws2_32.lib")int __cdecl main(int argc, char **argv) { /
VB模拟发送ICMP数据包(代码直接可用)
jemcliu的专栏
01-14 878
*********************************************************************         程序设计 河南工业大学信息网-http://www.hautbbs.com.cn本站以方便在校师生信息交流为宗旨，是一个集信息传递、资料查询、娱乐交友为一体的校园网络平台!我站为您免费提供信息平台,您只需要注册一个通行证即可轻松拥有属于
.NET Compact Framework下的Ping(ICMP)的开发
weixin_33832340的博客
11-05 98
什么是 Ping Tester? Ping Tester是一个网络侦测工具(Diagnostics)，可以使用在Windows Mobile来检查网络的联通性。 简介 文本讲述了在.NET Compact Framework下ping功能的实现。 主要通过P/Invoke的方式调用ICMP相关的API来实现。 同时提供一个Windows Mobile...
VC++调用IcmpSendEcho函数实现对远端地址的ping检测（附源码）
dvlinker的技术专栏
04-22 8646
调用IcmpSendEcho函数实现对远端地址的ping检测
自制Ping(2) Structures
安静的自娱自乐
01-22 1208
IP Helper ICMP相关接口主要用到两个结构, ICMP_ECHO_REPLY和IP_OPTION_INFORMATION ICMP_ECHO_REPLY structure ICMP_ECHO_REPLY表示IPv4请求的响应信息所返回的数据 语法 typedef struct icmp_echo_reply { IPAddr Address;
该如何使用IcmpSendEcho
最新发布
06-13
使用IcmpSendEcho函数，您需要做以下几步： 1. 加载icmp.dll库文件。 2. 创建ICMP Echo请求数据包。 3. 打开ICMP句柄。 4. 使用IcmpSendEcho函数发送ICMP Echo请求。 5. 处理IcmpSendEcho函数返回的ICMP Echo响应数据包。 下面是一个简单的使用IcmpSendEcho函数的示例代码： ``` #include <winsock2.h> #include <iphlpapi.h> #include <icmpapi.h> #include <stdio.h> #pragma comment(lib, "iphlpapi.lib") #pragma comment(lib, "ws2_32.lib") int main() { HANDLE icmpHandle = IcmpCreateFile(); if (icmpHandle == INVALID_HANDLE_VALUE) { printf("Failed to create ICMP handle.\n"); return 1; } char ipAddress[] = "www.google.com"; DWORD ipAddr = inet_addr(ipAddress); if (ipAddr == INADDR_NONE) { hostent* host = gethostbyname(ipAddress); if (host == NULL) { printf("Failed to get IP address of %s.\n", ipAddress); return 1; } ipAddr = *((DWORD*)host->h_addr); } const int bufferSize = 32; char buffer[bufferSize]; memset(buffer, 0, bufferSize); int replySize = sizeof(ICMP_ECHO_REPLY) + bufferSize; LPVOID replyBuffer = (void*)malloc(replySize); if (replyBuffer == NULL) { printf("Failed to allocate memory for reply buffer.\n"); return 1; } ICMP_ECHO_REPLY* reply = (ICMP_ECHO_REPLY*)replyBuffer; int result = IcmpSendEcho(icmpHandle, ipAddr, buffer, bufferSize, NULL, replyBuffer, replySize, 1000); if (result == 0) { printf("IcmpSendEcho failed with error: %ld\n", GetLastError()); return 1; } printf("Reply from %s: bytes=%d time=%ldms TTL=%d\n", ipAddress, reply->DataSize, reply->RoundTripTime, reply->Options.Ttl); free(replyBuffer); IcmpCloseHandle(icmpHandle); return 0; } ``` 这个示例代码会尝试向www.google.com发送ICMP Echo请求，并输出响应数据包的信息。注意，这个示例代码仅供参考，并不保证在所有环境中都能正常工作。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值