Icmp6ParseReplies 関数 (icmpapi.h)

[アーティクル]
08/24/2023

Icmp6ParseReplies 関数は、指定された応答バッファーを解析し、見つかった場合は IPv6 ICMPv6 エコー応答応答を返します。

構文

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

パラメーター

[in] ReplyBuffer

Icmp6SendEcho2 関数に渡されるバッファーへのポインター。このパラメーターは、応答を保持する ICMPV6_ECHO_REPLY 構造体を指します。

[in] ReplySize

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

戻り値

Icmp6ParseReplies 関数は、成功すると 1 を返します。この場合、ReplyBuffer パラメーターが指すICMPV6_ECHO_REPLY構造体の Status メンバーは、ターゲットノードが応答した場合にIP_SUCCESSされるか、IP_TTL_EXPIRED_TRANSIT。

戻り値が 0 の場合は、 GetLastError を使用して拡張エラー情報を使用できます。

リターンコード	説明
ERROR_GEN_FAILURE	一般的なエラーが発生しました。このエラーは、 ReplyBuffer パラメーターが NULL ポインターであるか、 ReplySize パラメーターが 0 の場合に返されます。
その他	FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

注釈

Icmp6ParseReplies 関数は、ICMPv6 エコー要求に起因する応答を解析するために IPv6 によって使用されます。 Icmp6ParseReplies 関数は、以前に Icmp6SendEcho2 関数に渡された応答バッファーを解析します。 Icmp6ParseReplies 関数は、Icmp6SendEcho2 関数でのみ使用します。

Icmp6ParseReplies 関数は、以前に IcmpSendEcho または IcmpSendEcho2 for IPv4 に渡された応答バッファーでは使用できません。

IPv4 の場合は、 IcmpCreateFile、 IcmpSendEcho、 IcmpSendEcho2、 IcmpSendEcho2Ex、および IcmpParseReplies 関数を使用します。

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

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	icmpapi.h
Library	Iphlpapi.lib
[DLL]	Iphlpapi.dll