Icmp6CreateFile 函数 (icmpapi.h)

项目
08/24/2023

Icmp6CreateFile 函数打开一个句柄，可在该句柄上发出 IPv6 ICMP 回显请求。

语法

IPHLPAPI_DLL_LINKAGE HANDLE Icmp6CreateFile();

返回值

Icmp6CreateFile 函数在成功时返回打开的句柄。失败时，函数返回 INVALID_HANDLE_VALUE。调用 GetLastError 函数以获取扩展错误信息。

注解

Icmp6CreateFile 函数打开一个句柄，可在该句柄上发出 IPv6 ICMP 回显请求。 Icmp6SendEcho2 函数用于发送 IPv6 ICMP 回显请求。 Icmp6ParseReplies 函数用于分析 IPv6 ICMP 回复。 IcmpCloseHandle 函数用于关闭 Icmp6CreateFile 函数打开的 ICMP 句柄。

对于 IPv4，请使用 IcmpCreateFile 函数。

对于 IPv4，请使用 IcmpCreateFile、 IcmpSendEcho、 IcmpSendEcho2、 IcmpSendEcho2Ex 和 IcmpParseReplies 函数。

请注意， Iphlpapi.h 头文件的 include 指令必须放在 Icmpapi.h 头文件之前。

示例

以下示例打开一个句柄，可在该句柄上发出 IPv6 ICMP 回显请求。

#include <windows.h>
#include <stdio.h>
#include <iphlpapi.h>
#include <icmpapi.h>
#pragma comment(lib, "IPHLPAPI.lib")

void main()
{
    HANDLE hIcmpFile;

    hIcmpFile = Icmp6CreateFile();
    if (hIcmpFile == INVALID_HANDLE_VALUE) {
      printf("\tUnable to open handle.\n");
      printf("Icmp6Createfile returned error: %ld\n", GetLastError() );
    }
    else
      printf("\tHandle created.\n");
}

要求


最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	icmpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll