Funzione IcmpCloseHandle (icmpapi.h)

La funzione IcmpCloseHandle chiude un handle aperto da una chiamata alle funzioni IcmpCreateFile o Icmp6CreateFile.

Sintassi

IPHLPAPI_DLL_LINKAGE BOOL IcmpCloseHandle(
  [in] HANDLE IcmpHandle
);

Parametri

[in] IcmpHandle

Handle da chiudere. Questo handle deve essere stato restituito da una chiamata a IcmpCreateFile o Icmp6CreateFile.

Valore restituito

Se l'handle viene chiuso correttamente, il valore restituito è TRUE, in caso contrario FALSE. Chiamare la funzione GetLastError per informazioni sull'errore estese.

Commenti

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

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

Esempio

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

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

#pragma comment(lib, "iphlpapi.lib")

void main()
{
    HANDLE hIcmpFile;
    BOOL bRetVal; 

    hIcmpFile = IcmpCreateFile();
    if (hIcmpFile == INVALID_HANDLE_VALUE)
      printf("IcmpCreateFile failed with error: %ld\n", GetLastError() );
    else 
    {
      printf("\tHandle created.\n");

      bRetVal = IcmpCloseHandle(hIcmpFile);
      if (bRetVal)
          printf("\tHandle was closed\n");
      else
          printf("IcmpCloseHandle failed with error: %ld\n", GetLastError() );
    }
}

Requisiti

Vedi anche

Getlasterror

Icmp6CreateFile

Icmp6ParseReplies

Icmp6SendEcho2

IcmpCreateFile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex