目录
IcmpSendEcho2Ex function
语法
参数
返回值
备注
要求
首页 数据库 mysql教程 自制Ping(1) IcmpSendEcho2Ex function

自制Ping(1) IcmpSendEcho2Ex function

Jun 07, 2016 pm 03:42 PM
ping 自制

IcmpSendEcho2Ex function IcmpSendEcho2Ex 发送 IPv4 ICMP 请求 , 立即返回 ( 如果 Event 或 ApcRoutine 非空 ) 或等超时后返回 . ReplyBuffer 中存放 ICMP 响应 ( 如果有 ). 语法 DWORD WINAPI IcmpSendEcho2Ex( _In_ HANDLE IcmpHandle, _In_opt_ HANDLE

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_REPLYICMP_ECHO_REPLY32时会返回该错误.

ERROR_IO_PENDING

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

ERROR_NOT_ENOUGH_MEMORY

内存不足

ERROR_NOT_SUPPORTED

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

IP_BUF_TOO_SMALL

ReplySize指定的太小.

Other

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

 

备注

IcmpSendEcho2ExWin Ser 2008及以上操作系统中可用.

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

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

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

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

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

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

如果EventApcRoutine都指定了, 会使用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, 使用Icmp6CreateFileIcmp6SendEcho2, 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

 

本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

AI Hentai Generator

AI Hentai Generator

免费生成ai无尽的。

热门文章

R.E.P.O.能量晶体解释及其做什么(黄色晶体)
2 周前 By 尊渡假赌尊渡假赌尊渡假赌
仓库:如何复兴队友
4 周前 By 尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island冒险:如何获得巨型种子
3 周前 By 尊渡假赌尊渡假赌尊渡假赌

热工具

记事本++7.3.1

记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版

SublimeText3汉化版

中文版,非常好用

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

Dreamweaver CS6

Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版

SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

如何修复 Xbox Series S/X 下载速度、降低 ping 和延迟 如何修复 Xbox Series S/X 下载速度、降低 ping 和延迟 Apr 16, 2023 pm 04:49 PM

多年来,Xbox控制台得到了突飞猛进的改进。多年来,游戏不断发展,具有栩栩如生的功能,而游戏玩家似乎无法获得足够的体验。在Xbox上玩您最喜欢的游戏可能是一种完全引人入胜的体验。但是,有时使用这些高级功能,如果互联网速度不是那么好,我们最终会遇到延迟或ping问题。有时我们希望游戏下载速度更快。如今,像ForzaHorizo​​n5和MortalKombat这样的游戏需要超过100GB的内存。如果我们没有正确的互联网设置来帮助我们,下载此类游戏可能需要很长时间。方法1:通过

ping请求超时是什么原因 ping请求超时是什么原因 Aug 28, 2023 pm 04:17 PM

ping请求超时的原因有目标主机不可达、网络拥堵、防火墙或安全设置和DNS解析问题等。详细介绍:1、目标主机不可达,Ping请求超时可能意味着目标主机无法通过网络访问,可能是由于目标主机关闭了网络连接、目标主机所在的网络出现故障、目标主机IP地址设置错误等原因导致;2、网络拥堵,Ping请求超时也可能是由于网络拥堵导致的,网络拥堵可能是由于大量的数据传输、网络设备故障等等。

网关Ping不通怎么回事?Ping不通什么原因? 网关Ping不通怎么回事?Ping不通什么原因? Mar 13, 2024 pm 03:40 PM

  网络ping不通,是什么回事?其实这是个非常常见的问题了,主要分为两种情况,同网段ping不通和不同网段ping不通,下面就来看看详细内容吧。  同网段ping不通的原因ping命令无法连接的情况通常有两种:一是在同一网段内无法ping通的IP地址,另一种是在不同网段内无法ping通的IP地址。这两种情况具有不同的解决方法。首先,我们来讨论在同一网段内ping不通的情况。  一、同网段ping不通,结果是“无法访问目标主机”  目的ip和源ip是同一网段的,ping的结果是&l

报错提示“ping不是内部或外部命令也不是可运行程序”怎么解决 报错提示“ping不是内部或外部命令也不是可运行程序”怎么解决 Feb 22, 2023 pm 04:28 PM

解决方法:1、点击“开始”按钮,在开始菜单中依次点击“控制面板”-“系统”;2、在设置界面,依次点击“高级系统设置”-“高级”-“环境变量”;3、查看Administrator的用户变量中是否有Path变量,若是没有看到此变量,点击“新建”,添加变量Path和变量值即可。

ping不通ip地址的原因有哪些 ping不通ip地址的原因有哪些 Dec 15, 2020 pm 04:37 PM

ping不通ip地址的原因有:1、对方关机或ip地址不存在;2、网段不同,通过路由无法找到;3、防火墙过滤了ping发出的ICMP数据包;4、ip地址设置错误;5、网线故障;6、未设置网关。

几个简单的linux ping命令使用示例 几个简单的linux ping命令使用示例 Jan 09, 2024 am 08:26 AM

发觉linux下的ping命令花样还挺多的,下面是几个例子1、pingwww.baidu.com,最粗糙的用法,此时主机将不停地向目的地址发送ICMPechorequest数据包,直至你按下Ctrl+c2、ping-Ieth0www.baidu.com或ping-I192.168.8.151www.baidu.com,即-I选项可以指定发送ping包的网卡,-I后接网卡名或者网卡的IP地址都是可以的3、ping-c3www.baidu.com,-c选项可以指定发送多少个ICMP包,可以看到主机接

ping的ttl值初略判断操作系统类别有哪些 ping的ttl值初略判断操作系统类别有哪些 May 22, 2023 am 09:04 AM

往往可以通过ping的ttl值初略的判断一些操作系统的类别,这边整理一下大概如下UNIX及类UNIX操作系统ICMP回显应答的TTL字段值为255CompaqTru645.0ICMP回显应答的TTL字段值为64微软WindowsNT/2K操作系统ICMP回显应答的TTL字段值为128微软Windows95操作系统ICMP回显应答的TTL字段值为32当然这些ttl值还可以更改,Windows系列的系统可以通过修改注册表以下键值实现:[HKEY_LOCAL_MACHINE\system\Curren

ping不通是什么原因 ping不通是什么原因 Oct 11, 2023 am 10:45 AM

ping不通的原因有网络故障、防火墙设置、目标主机故障、网络配置等等问题。解决办法:1、检查网络连接,确保网络连接正常;2、检查DNS设置,确保DNS服务器设置正确,可以尝试使用其他可靠的DNS服务器;3、调整防火墙设置,检查目标主机和本地计算机的防火墙设置,确保允许Ping请求通过;4、检查目标主机状态是否正常和检查IP地址和子网掩码是否设置正确等等。

See all articles