Icmp6CreateFile, fonction (icmpapi.h)
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 |
Voir aussi
IcmpSendEcho