Icmp6ParseReplies-Funktion (icmpapi.h)

Artikel
03/06/2024

Die Icmp6ParseReplies-Funktion analysiert den bereitgestellten Antwortpuffer und gibt eine IPv6-ICMPv6-Echoantwort zurück, wenn sie gefunden wurde.

Syntax

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

Parameter

[in] ReplyBuffer

Ein Zeiger auf den Puffer, der an die Icmp6SendEcho2-Funktion übergeben wird. Dieser Parameter verweist auf eine ICMPV6_ECHO_REPLY-Struktur , die die Antwort enthält.

[in] ReplySize

Die Größe des Puffers in Bytes, auf den der ReplyBuffer-Parameter verweist.

Rückgabewert

Die Icmp6ParseReplies-Funktion gibt bei Erfolg 1 zurück. In diesem Fall ist das Statuselement in der ICMPV6_ECHO_REPLY Struktur, auf die der ReplyBuffer-Parameter verweist, entweder IP_SUCCESS , wenn der Zielknoten geantwortet hat, oder IP_TTL_EXPIRED_TRANSIT.

Wenn der Rückgabewert 0 ist, sind erweiterte Fehlerinformationen über GetLastError verfügbar.

Rückgabecode	Beschreibung
ERROR_GEN_FAILURE	Ein allgemeiner Fehler ist aufgetreten. Dieser Fehler wird zurückgegeben, wenn der ReplyBuffer-Parameter ein NULL-Zeiger oder der ReplySize-Parameter 0 ist.
Andere	Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die Icmp6ParseReplies-Funktion wird von IPv6 verwendet, um Antworten zu analysieren, die aus einer ICMPv6-Echoanforderung resultieren. Die Icmp6ParseReplies-Funktion analysiert einen Antwortpuffer, der zuvor an die Icmp6SendEcho2-Funktion übergeben wurde. Verwenden Sie die Icmp6ParseReplies-Funktion nur mit der Icmp6SendEcho2-Funktion .

Die Icmp6ParseReplies-Funktion kann nicht für einen Antwortpuffer verwendet werden, der zuvor für IPv4 an IcmpSendEcho oder IcmpSendEcho2 übergeben wurde.

Verwenden Sie für IPv4 die Funktionen IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex und IcmpParseReplies .

Beachten Sie, dass die include-Anweisung für die Headerdatei Iphlpapi.h vor der Headerdatei Icmpapi.h platziert werden muss.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	icmpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll