Icmp6CreateFile-Funktion (icmpapi.h)
Die Icmp6CreateFile-Funktion öffnet ein Handle, für das IPv6 ICMP-Echoanforderungen ausgegeben werden können.
Syntax
IPHLPAPI_DLL_LINKAGE HANDLE Icmp6CreateFile();
Rückgabewert
Die Icmp6CreateFile-Funktion gibt bei Erfolg ein geöffnetes Handle zurück. Bei einem Fehler gibt die Funktion INVALID_HANDLE_VALUE zurück. Rufen Sie die GetLastError-Funktion für erweiterte Fehlerinformationen auf.
Hinweise
Die Icmp6CreateFile-Funktion öffnet ein Handle, für das IPv6 ICMP-Echoanforderungen ausgegeben werden können. Die Icmp6SendEcho2-Funktion wird verwendet, um die IPv6 ICMP-Echoanforderungen zu senden. Die Icmp6ParseReplies-Funktion wird verwendet, um die IPv6-ICMP-Antworten zu analysieren. Die IcmpCloseHandle-Funktion wird verwendet, um das ICMP-Handle zu schließen, das von der Icmp6CreateFile-Funktion geöffnet wird.
Verwenden Sie für IPv4 die IcmpCreateFile-Funktion .
Verwenden Sie für IPv4 die Funktionen IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex und IcmpParseReplies .
Beachten Sie, dass die include-Direktive für die Headerdatei Iphlpapi.h vor der Headerdatei Icmpapi.h platziert werden muss.
Beispiele
Im folgenden Beispiel wird ein Handle geöffnet, für das IPv6-ICMP-Echoanforderungen ausgegeben werden können.
#include <windows.h>
#include <stdio.h>
#include <iphlpapi.h>
#include <icmpapi.h>
#pragma comment(lib, "IPHLPAPI.lib")
void main()
{
HANDLE hIcmpFile;
hIcmpFile = Icmp6CreateFile();
if (hIcmpFile == INVALID_HANDLE_VALUE) {
printf("\tUnable to open handle.\n");
printf("Icmp6Createfile returned error: %ld\n", GetLastError() );
}
else
printf("\tHandle created.\n");
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | icmpapi.h |
| Bibliothek | Iphlpapi.lib |
| DLL | Iphlpapi.dll |
Weitere Informationen
IcmpSendEcho