Fungsi GetBestInterfaceEx (iphlpapi.h)

Fungsi GetBestInterfaceEx mengambil indeks antarmuka yang memiliki rute terbaik ke alamat IPv4 atau IPv6 yang ditentukan.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetBestInterfaceEx(
  [in]  sockaddr *pDestAddr,
  [out] PDWORD   pdwBestIfIndex
);

Parameter-parameternya

[in] pDestAddr

Alamat IPv6 atau IPv4 tujuan untuk mengambil antarmuka dengan rute terbaik, dalam bentuk struktur sockaddr .

[out] pdwBestIfIndex

Penunjuk ke indeks antarmuka dengan rute terbaik ke alamat IPv6 atau IPv4 yang ditentukan oleh pDestAddr.

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 parameter pDestAddr atau pdwBestIfIndex menunjuk ke memori yang tidak dapat diakses. Kesalahan ini juga dapat dikembalikan jika parameter 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 dan alamat IPv4 ditentukan dalam parameter pDestAddr atau tidak ada tumpukan IPv6 di komputer lokal dan alamat IPv6 ditentukan dalam parameter pDestAddr .
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

Fungsi GetBestInterfaceEx berbeda dari fungsi GetBestInterface karena dapat digunakan dengan alamat IPv4 atau IPv6.

Anggota Keluarga dari struktur sockaddr yang diarahkan oleh parameter pDestAddr harus diatur ke salah satu nilai berikut: AF_INET atau AF_INET6.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	iphlpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll

Lihat juga

GetBestInterface

Referensi Fungsi Pembantu IP

Halaman Mulai Pembantu IP

MIB_BEST_IF

sockaddr