Icmp6CreateFile 関数 (icmpapi.h)

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");
}

要件

関連項目

GetLastError

Icmp6ParseReplies

Icmp6SendEcho2

IcmpCloseHandle

IcmpCreateFile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex