次の方法で共有


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 の場合は、 IcmpCreateFileIcmpSendEchoIcmpSendEcho2IcmpSendEcho2Ex、および 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

関連項目

GetLastError

Icmp6ParseReplies

Icmp6SendEcho2

IcmpCloseHandle

IcmpCreateFile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex