Fungsi IcmpParseReplies (icmpapi.h)

Artikel
08/24/2023

Fungsi IcmpParseReplies mengurai buffer balasan yang disediakan dan mengembalikan jumlah respons permintaan gema ICMP yang ditemukan.

Sintaks

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

Parameter

[in] ReplyBuffer

Buffer diteruskan ke IcmpSendEcho2. Ini ditulis ulang untuk menyimpan array struktur ICMP_ECHO_REPLY , jenisnya PICMP_ECHO_REPLY.

Pada platform 64-bit, buffer ini ditulis ulang untuk menyimpan array struktur ICMP_ECHO_REPLY32 , jenisnya PICMP_ECHO_REPLY32.

[in] ReplySize

Ukuran, dalam byte, dari buffer yang diacu oleh parameter ReplyBuffer .

Menampilkan nilai

Fungsi IcmpParseReplies mengembalikan jumlah respons ICMP yang ditemukan pada keberhasilan. Fungsi mengembalikan nol pada kesalahan. Panggil GetLastError untuk informasi kesalahan tambahan.

Keterangan

Fungsi IcmpParseReplies tidak boleh digunakan pada buffer balasan yang sebelumnya diteruskan ke IcmpSendEcho. Fungsi IcmpSendEcho mengurai buffer tersebut sebelum kembali ke pengguna. Gunakan fungsi ini hanya dengan IcmpSendEcho2.

Fungsi IcmpParseReplies diekspor dari Icmp.dll pada Windows 2000. Fungsi IcmpParseReplies diekspor dari Iphlpapi.dll pada Windows XP dan yang lebih baru. Pemeriksaan versi Windows tidak disarankan untuk menggunakan fungsi ini. Aplikasi yang membutuhkan portabilitas dengan fungsi ini di windows 2000, Windows XP, Windows Server 2003 dan versi Windows yang lebih baru tidak boleh secara statis ditautkan ke file Icmp.lib atau Iphlpapi.lib . Sebagai gantinya, aplikasi harus memeriksa keberadaan IcmpParseReplies di Iphlpapi.dll dengan panggilan ke LoadLibrary dan GetProcAddress. Gagal itu, aplikasi harus memeriksa keberadaan IcmpParseReplies di Icmp.dll dengan panggilan ke LoadLibrary dan GetProcAddress.

Perhatikan bahwa direktif sertakan untuk file header Iphlpapi.h harus ditempatkan sebelum file header Icmpapi.h .

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	icmpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll pada Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP; Icmp.dll di Windows 2000 Server dan Windows 2000 Professional