Icmp6CreateFile-Funktion (icmpapi.h)

Artikel
08/24/2023

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