Fungsi GetBestInterface (iphlpapi.h)

Fungsi GetBestInterface mengambil indeks antarmuka yang memiliki rute terbaik ke alamat IPv4 yang ditentukan.

Sintaksis

IPHLPAPI_DLL_LINKAGE DWORD GetBestInterface(
  [in]  IPAddr dwDestAddr,
  [out] PDWORD pdwBestIfIndex
);

Parameter-parameternya

[in] dwDestAddr

Alamat IPv4 tujuan untuk mengambil antarmuka yang memiliki rute terbaik, dalam bentuk struktur IPAddr .

[out] pdwBestIfIndex

Pointer ke variabel DWORD yang menerima indeks antarmuka yang memiliki rute terbaik ke alamat IPv4 yang ditentukan oleh dwDestAddr.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, nilai pengembalian adalah salah satu kode kesalahan berikut.

Mengembalikan kode	Description
ERROR_CAN_NOT_COMPLETE	Operasi tidak dapat diselesaikan.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika pointer NULL diteruskan dalam parameter pdwBestIfIndex atau jika pdwBestIfIndex menunjuk ke memori yang tidak dapat ditulis.
ERROR_NOT_SUPPORTED	Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 di komputer lokal.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

Fungsi GetBestInterface hanya berfungsi dengan alamat IPv4. Untuk digunakan dengan alamat IPv6, GetBestInterfaceEx harus digunakan.

Untuk informasi tentang jenis data IPAddr, lihat jenis data Windows. Untuk mengonversi alamat IP antara notasi desimal putus-putus dan format IPAddr , gunakan fungsi inet_addr dan inet_ntoa .

Pada Windows Vista dan yang lebih baru, parameter pdwBestIfIndex diperlakukan secara internal oleh IP Helper sebagai penunjuk ke NET_IFINDEX datatype.

Requirements

Requirement	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	iphlpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll

Baca juga

GetBestInterfaceEx

GetBestRoute

Referensi Fungsi Pembantu IP

Halaman Mulai Pembantu IP

IPAddr

MIB_BEST_IF

Jenis Data Windows