Fungsi Icmp6ParseReplies (icmpapi.h)

Artikel
02/28/2024

Fungsi Icmp6ParseReplies mengurai buffer balasan yang disediakan dan mengembalikan balasan respons gema IPv6 ICMPv6 jika ditemukan.

Sintaks

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

Parameter

[in] ReplyBuffer

Penunjuk ke buffer yang diteruskan ke fungsi Icmp6SendEcho2 . Parameter ini menunjuk ke struktur ICMPV6_ECHO_REPLY untuk menahan respons.

[in] ReplySize

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

Nilai kembali

Fungsi Icmp6ParseReplies mengembalikan 1 pada keberhasilan. Dalam hal ini, anggota Status dalam struktur ICMPV6_ECHO_REPLY yang ditunjukkan oleh parameter ReplyBuffer akan IP_SUCCESS jika simpul target merespons atau IP_TTL_EXPIRED_TRANSIT.

Jika nilai yang dikembalikan adalah nol, informasi kesalahan yang diperluas tersedia melalui GetLastError.

Menampilkan kode	Deskripsi
ERROR_GEN_FAILURE	Kegagalan umum terjadi. Kesalahan ini dikembalikan jika parameter ReplyBuffer adalah penunjuk NULL atau parameter ReplySize adalah nol.
Lainnya	Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi Icmp6ParseReplies digunakan oleh IPv6 untuk mengurai balasan yang dihasilkan dari permintaan gema ICMPv6. Fungsi Icmp6ParseReplies mengurai buffer balasan yang sebelumnya diteruskan ke fungsi Icmp6SendEcho2 . Gunakan fungsi Icmp6ParseReplies hanya dengan fungsi Icmp6SendEcho2 .

Fungsi Icmp6ParseReplies tidak dapat digunakan pada buffer balasan yang sebelumnya diteruskan ke IcmpSendEcho atau IcmpSendEcho2 untuk IPv4.

Untuk IPv4, gunakan fungsi IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex, dan IcmpParseReplies .

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	icmpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll