Fungsi GetBestInterface (iphlpapi.h)

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

Sintaks

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

Parameter

[in] dwDestAddr

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

[out] pdwBestIfIndex

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

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

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

Menampilkan kode	Deskripsi
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.

Keterangan

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 Pembantu IP sebagai penunjuk ke jenis data NET_IFINDEX .

Persyaratan

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

Lihat juga

GetBestInterfaceEx

GetBestRoute

Referensi Fungsi Pembantu IP

Halaman Mulai Pembantu IP

IPAddr

MIB_BEST_IF

Jenis Data Windows