icmp6ParseReplies 函式 (icmpapi.h)

發行項
03/05/2024

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。在此情況下，如果目標節點回應或IP_TTL_EXPIRED_TRANSIT，則 ReplyBuffer 參數所指向之ICMPV6_ECHO_REPLY結構中的 Status 成員將會是IP_SUCCESS。

如果傳回值為零，則可透過 GetLastError 取得擴充錯誤資訊。

傳回碼	Description
ERROR_GEN_FAILURE	發生一般失敗。如果 ReplyBuffer 參數為 NULL 指標或 ReplySize 參數為零，則會傳回此錯誤。
其他	使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

IPv6 會使用 Icmp6ParseReplies 函式來剖析 ICMPv6 回應要求所產生的回復。 Icmp6ParseReplies 函式會剖析先前傳遞至 Icmp6SendEcho2 函式的回復緩衝區。僅搭配Icmp6SendEcho2函式使用Icmp6ParseReplies函式。

Icmp6ParseReplies 函式不能用於先前傳遞至 IcmpSendEcho 或 IcmpSendEcho2 for IPv4 的回復緩衝區。

針對 IPv4，請使用 IcmpCreateFile、 IcmpSendEcho、 IcmpSendEcho2、 IcmpSendEcho2Ex 和 IcmpParseReplies 函式。

請注意， Iphlpapi.h 頭檔的 include 指示詞必須放在 Icmpapi.h 頭檔之前。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	icmpapi.h
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll