IcmpParseReplies 関数 (icmpapi.h)

IcmpParseReplies 関数は、指定された応答バッファーを解析し、見つかった ICMP エコー要求応答の数を返します。

構文

IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
  [in] LPVOID ReplyBuffer,
  [in] DWORD  ReplySize
);

パラメーター

[in] ReplyBuffer

IcmpSendEcho2 に渡されるバッファー。 これは、ICMP_ECHO_REPLY構造体の配列 を 保持するように書き換えられ、その型は PICMP_ECHO_REPLY。

64 ビット プラットフォームでは、このバッファーは ICMP_ECHO_REPLY32 構造体の配列を保持するように書き換えられ、その型は PICMP_ECHO_REPLY32。

[in] ReplySize

ReplyBuffer パラメーターが指すバッファーのサイズ (バイト単位)。

戻り値

IcmpParseReplies 関数は、成功時に検出された ICMP 応答の数を返します。 この関数は、エラー時に 0 を返します。 追加のエラー情報については 、GetLastError を呼び出します。

解説

IcmpParseReplies 関数は、以前に IcmpSendEcho に渡された応答バッファーでは使用しないでください。 IcmpSendEcho 関数は、ユーザーに戻る前にそのバッファーを解析します。 この関数は 、IcmpSendEcho2 でのみ使用します。

IcmpParseReplies 関数は、Windows 2000 の Icmp.dll からエクスポートされます。 IcmpParseReplies 関数は、Windows XP 以降の Iphlpapi.dll からエクスポートされます。 Windows バージョン チェックは、この関数を使用することはお勧めしません。 Windows 2000、Windows XP、Windows Server 2003 以降の Windows バージョンでこの機能を使用して移植性を必要とするアプリケーションは、 Icmp.lib または Iphlpapi.lib ファイルに静的にリンクしないでください。 代わりに、アプリケーションは、LoadLibrary と GetProcAddress の呼び出しを使用して、Iphlpapi.dll に IcmpParseReplies が存在することをチェックする必要があります。 失敗した場合、アプリケーションは LoadLibrary と GetProcAddress の呼び出しを使用して、Icmp.dll に IcmpParseReplies が存在することをチェックする必要があります。

Iphlpapi.h ヘッダー ファイルの include ディレクティブは、Icmpapi.h ヘッダー ファイルの前に配置する必要があることに注意してください。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	icmpapi.h
Library	Iphlpapi.lib
[DLL]	Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の Iphlpapi.dll。Windows 2000 Server および Windows 2000 Professional での Icmp.dll

関連項目

GetLastError

ICMP_ECHO_REPLY

ICMP_ECHO_REPLY32

Icmp6CreateFile

Icmp6ParseReplies

Icmp6SendEcho2

IcmpCloseHandle

IcmpCreateFile

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex