icmpParseReplies 函式 (icmpapi.h)

發行項
08/24/2023

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 回應數目。函式會在錯誤時傳回零。呼叫 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 檔案。相反地，應用程式應該檢查Iphlpapi.dll中是否有IcmpParseReplies，並呼叫LoadLibrary和GetProcAddress。失敗，應用程式應該檢查Icmp.dll中是否有IcmpParseReplies，並呼叫LoadLibrary和GetProcAddress。

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

需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	icmpapi.h
程式庫	Iphlpapi.lib
Dll	windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP 上的 Iphlpapi.dll;Windows 2000 Server 和 Windows 2000 專業版上的 Icmp.dll