Icmp6CreateFile 函式 (icmpapi.h)

發行項
08/24/2023

Icmp6CreateFile函式會開啟可發出 IPv6 ICMP 回應要求的控制碼。

Syntax

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
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll