Fungsi IcmpCloseHandle (icmpapi.h)

Fungsi IcmpCloseHandle menutup handel yang dibuka oleh panggilan ke fungsi IcmpCreateFile atau Icmp6CreateFile .

Sintaks

IPHLPAPI_DLL_LINKAGE BOOL IcmpCloseHandle(
  [in] HANDLE IcmpHandle
);

Parameter

[in] IcmpHandle

Pegangan untuk menutup. Handel ini harus dikembalikan oleh panggilan ke IcmpCreateFile atau Icmp6CreateFile.

Menampilkan nilai

Jika handel berhasil ditutup, nilai yang dikembalikan adalah TRUE, jika tidak FALSE. Panggil fungsi GetLastError untuk informasi kesalahan yang diperluas.

Keterangan

Fungsi IcmpCloseHandle diekspor dari Icmp.dll pada Windows 2000. Fungsi IcmpCloseHandle diekspor dari Iphlpapi.dll pada Windows XP dan yang lebih baru. Pemeriksaan versi Windows tidak disarankan untuk menggunakan fungsi ini. Aplikasi yang membutuhkan portabilitas dengan fungsi ini di windows 2000, Windows XP, Windows Server 2003 dan versi Windows yang lebih baru tidak boleh secara statis ditautkan ke file Icmp.lib atau Iphlpapi.lib . Sebagai gantinya, aplikasi harus memeriksa keberadaan IcmpCloseHandle di Iphlpapi.dll dengan panggilan ke LoadLibrary dan GetProcAddress. Gagal itu, aplikasi harus memeriksa keberadaan IcmpCloseHandle di Icmp.dll dengan panggilan ke LoadLibrary dan GetProcAddress.

Perhatikan bahwa direktif include untuk file header Iphlpapi.h harus ditempatkan sebelum file header Icmpapi.h .

Contoh

Contoh berikut membuka dan menutup handel tempat permintaan gema ICMP dapat dikeluarkan.

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

Persyaratan

Lihat juga

GetLastError

Icmp6CreateFile

Icmp6ParseReplies

Icmp6SendEcho2

IcmpCreateFile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex