Icmp6ParseReplies-Funktion (icmpapi.h)
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 |
|---|---|
|
Ein allgemeiner Fehler ist aufgetreten. Dieser Fehler wird zurückgegeben, wenn der ReplyBuffer-Parameter ein NULL-Zeiger oder der ReplySize-Parameter 0 ist. |
|
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 |
Weitere Informationen
IcmpSendEcho