IcmpParseReplies-Funktion (icmpapi.h)

Artikel
08/24/2023

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