icmp6ParseReplies 函式 (icmpapi.h)
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 |
---|---|
|
發生一般失敗。 如果 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 |
另請參閱
IcmpSendecho