Fungsi IcmpCreateFile (icmpapi.h)

Artikel
08/24/2023

Fungsi IcmpCreateFile membuka handel tempat permintaan gema ICMP IPv4 dapat dikeluarkan.

Sintaks

IPHLPAPI_DLL_LINKAGE HANDLE IcmpCreateFile();

Mengembalikan nilai

Fungsi IcmpCreateFile mengembalikan handel terbuka saat berhasil. Jika gagal, fungsi mengembalikan INVALID_HANDLE_VALUE. Panggil fungsi GetLastError untuk informasi kesalahan yang diperluas.

Keterangan

Fungsi IcmpCreateFile diekspor dari Icmp.dll pada Windows 2000. Fungsi IcmpCreateFile 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 IcmpCreateFile di Iphlpapi.dll dengan panggilan ke LoadLibrary dan GetProcAddress. Gagal itu, aplikasi harus memeriksa keberadaan IcmpCreateFile di Icmp.dll dengan panggilan ke LoadLibrary dan GetProcAddress.

Untuk IPv6, gunakan fungsi Icmp6CreateFile, Icmp6SendEcho2, dan Icmp6ParseReplies .

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

Contoh

Contoh berikut membuka handel di mana permintaan gema ICMP dapat dikeluarkan.

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

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	icmpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll pada Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP; Icmp.dll di Windows 2000 Server dan Windows 2000 Professional