IcmpParseReplies-Funktion (icmpapi.h)
Die IcmpParseReplies-Funktion analysiert den bereitgestellten Antwortpuffer und gibt die Anzahl der gefundenen ICMP-Echoanforderungsantworten zurück.
Syntax
IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
[in] LPVOID ReplyBuffer,
[in] DWORD ReplySize
);
Parameter
[in] ReplyBuffer
Der an IcmpSendEcho2 übergebene Puffer. Dies wird neu geschrieben, um ein Array von ICMP_ECHO_REPLY Strukturen zu enthalten, dessen Typ PICMP_ECHO_REPLY ist.
Auf einer 64-Bit-Plattform wird dieser Puffer so umgeschrieben, dass er ein Array von ICMP_ECHO_REPLY32 Strukturen enthält, dessen Typ PICMP_ECHO_REPLY32 ist.
[in] ReplySize
Die Größe des Puffers in Bytes, auf den der ReplyBuffer-Parameter verweist.
Rückgabewert
Die IcmpParseReplies-Funktion gibt die Anzahl der ICMP-Antworten zurück, die bei Erfolg gefunden wurden. Die Funktion gibt bei Fehler null zurück. Rufen Sie GetLastError auf, um weitere Fehlerinformationen zu erhalten.
Hinweise
Die IcmpParseReplies-Funktion sollte nicht für einen Antwortpuffer verwendet werden, der zuvor an IcmpSendEcho übergeben wurde. Die IcmpSendEcho-Funktion analysiert diesen Puffer, bevor sie an den Benutzer zurückgegeben wird. Verwenden Sie diese Funktion nur mit IcmpSendEcho2.
Die IcmpParseReplies-Funktion wird aus dem Icmp.dll unter Windows 2000 exportiert. Die IcmpParseReplies-Funktion wird aus dem Iphlpapi.dll unter Windows XP und höher exportiert. Die Windows-Versionsprüfung wird für die Verwendung dieser Funktion nicht empfohlen. Anwendungen, die Portabilität mit dieser Funktion in Windows 2000, Windows XP, Windows Server 2003 und höher erfordern, sollten weder statisch mit der Datei Icmp.lib noch mit der Datei Iphlpapi.lib verknüpft werden. Stattdessen sollte die Anwendung überprüfen, ob IcmpParseReplies im Iphlpapi.dll mit Aufrufen von LoadLibrary und GetProcAddress vorhanden ist. Andernfalls sollte die Anwendung überprüfen, ob IcmpParseReplies im Icmp.dll mit Aufrufen von LoadLibrary und GetProcAddress vorhanden ist.
Beachten Sie, dass die include-Direktive für die Headerdatei Iphlpapi.h vor der Headerdatei Icmpapi.h platziert werden muss.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | icmpapi.h |
| Bibliothek | Iphlpapi.lib |
| DLL | Iphlpapi.dll unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP; Icmp.dll unter Windows 2000 Server und Windows 2000 Professional |
Weitere Informationen
IcmpSendEcho