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
| 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 |
Vedi anche
IcmpSendEcho