Icmp6CreateFile, fonction (icmpapi.h)

Article
08/24/2023

La fonction Icmp6CreateFile ouvre un handle sur lequel les demandes d’écho ICMP IPv6 peuvent être émises.

Syntaxe

IPHLPAPI_DLL_LINKAGE HANDLE Icmp6CreateFile();

Valeur de retour

La fonction Icmp6CreateFile retourne un handle ouvert en cas de réussite. En cas d’échec, la fonction retourne INVALID_HANDLE_VALUE. Appelez la fonction GetLastError pour obtenir des informations d’erreur étendues.

Notes

La fonction Icmp6CreateFile ouvre un handle sur lequel les demandes d’écho ICMP IPv6 peuvent être émises. La fonction Icmp6SendEcho2 est utilisée pour envoyer les demandes d’écho ICMP IPv6. La fonction Icmp6ParseReplies est utilisée pour analyser les réponses ICMP IPv6. La fonction IcmpCloseHandle est utilisée pour fermer le handle ICMP ouvert par la fonction Icmp6CreateFile .

Pour IPv4, utilisez la fonction IcmpCreateFile .

Pour IPv4, utilisez les fonctions IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex et IcmpParseReplies .

Notez que la directive include pour le fichier d’en-tête Iphlpapi.h doit être placée avant le fichier d’en-tête Icmpapi.h .

Exemples

L’exemple suivant ouvre un handle sur lequel les demandes d’écho ICMP IPv6 peuvent être émises.

#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");
}

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	icmpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll