Funzione IcmpCreateFile (icmpapi.h)

Articolo
08/24/2023

La funzione IcmpCreateFile apre un handle in cui è possibile inviare richieste echo ICMP IPv4.

Sintassi

IPHLPAPI_DLL_LINKAGE HANDLE IcmpCreateFile();

Valore restituito

La funzione IcmpCreateFile restituisce un handle aperto in caso di esito positivo. In caso di errore, la funzione restituisce INVALID_HANDLE_VALUE. Chiamare la funzione GetLastError per informazioni sugli errori estese.

Commenti

La funzione IcmpCreateFile viene esportata dalla Icmp.dll in Windows 2000. La funzione IcmpCreateFile viene esportata dal Iphlpapi.dll in Windows XP e versioni successive. Il controllo delle versioni di Windows non è consigliato per usare questa funzione. Le applicazioni che richiedono portabilità con questa funzione in Windows 2000, Windows XP, Windows Server 2003 e versioni successive di Windows non devono essere collegate in modo statico al file Icmp.lib o Iphlpapi.lib . L'applicazione deve invece verificare la presenza di IcmpCreateFile nel Iphlpapi.dll con chiamate a LoadLibrary e GetProcAddress. In caso contrario, l'applicazione deve verificare la presenza di IcmpCreateFile nel Icmp.dll con chiamate a LoadLibrary e GetProcAddress.

Per IPv6, usare le funzioni Icmp6CreateFile, Icmp6SendEcho2 e Icmp6ParseReplies .

Si noti che la direttiva include per il file di intestazione Iphlpapi.h deve essere inserita prima del file di intestazione Icmpapi.h .

Esempio

Nell'esempio seguente viene aperto un handle in cui è possibile inviare richieste echo ICMP.

#include <windows.h>
#include <stdio.h>
#include <iphlpapi.h>
#include <icmpapi.h>

// Need to link with Iplhlapi.lib
#pragma comment(lib, "IPHLPAPI.lib")

void main()
{
    HANDLE hIcmpFile;

    hIcmpFile = IcmpCreateFile();
    if (hIcmpFile == INVALID_HANDLE_VALUE) {
      printf("\tUnable to open handle.\n");
      printf("IcmpCreatefile returned error: %ld\n", GetLastError() );
    }
    else {
      printf("\tHandle created.\n");
      // Need to close the handle when done using it
      IcmpCloseHandle(hIcmpFile);
    }  
}

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	icmpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll in Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP; Icmp.dll in Windows 2000 Server e Windows 2000 Professional