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
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

另請參閱

GetLastError

ICMPV6_ECHO_REPLY

ICMP_ECHO_REPLY

Icmp6CreateFile

Icmp6SendEcho2

IcmpCloseHandle

IcmpCreateFile

IcmpParseReplies

IcmpSendecho

IcmpSendEcho2

IcmpSendEcho2Ex