次の方法で共有


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 ファイルに静的にリンクしないでください。 代わりに、アプリケーションは、LoadLibraryGetProcAddress の呼び出しを使用して、Iphlpapi.dllIcmpParseReplies が存在することをチェックする必要があります。 失敗した場合、アプリケーションは LoadLibraryGetProcAddress の呼び出しを使用して、Icmp.dllIcmpParseReplies が存在することをチェックする必要があります。

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