Fungsi GetIfEntry2Ex (netioapi.h)

Artikel
03/15/2023

Fungsi GetIfEntry2Ex mengambil tingkat informasi yang ditentukan untuk antarmuka yang ditentukan di komputer lokal.

Sintaks

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfEntry2Ex(
  [in]      MIB_IF_ENTRY_LEVEL Level,
  [in, out] PMIB_IF_ROW2       Row
);

Parameter

[in] Level

Tingkat informasi antarmuka yang akan diambil. Parameter ini dapat menjadi salah satu nilai dari jenis enumerasi MIB_IF_ENTRY_LEVEL yang ditentukan dalam file header Netioapi.h .

Nilai	Makna
MibIfEntryNormal 0	Nilai statistik dan status yang dikembalikan dalam anggota struktur MIB_IF_ROW2 yang ditunjukkan oleh parameter Baris dikembalikan dari bagian atas tumpukan filter.
MibIfEntryNormalWithoutStatistics 2	Nilai status (tanpa statistik) yang dikembalikan dalam anggota struktur MIB_IF_ROW2 yang ditunjukkan oleh parameter Baris dikembalikan dari bagian atas tumpukan filter.

[in, out] Row

Penunjuk ke struktur MIB_IF_ROW2 yang, saat pengembalian berhasil, menerima informasi untuk antarmuka di komputer lokal. Pada input, InterfaceLuid atau anggota InterfaceIndex dari MIB_IF_ROW2 harus diatur ke antarmuka untuk mengambil informasi.

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_FILE_NOT_FOUND	Sistem tidak dapat menemukan file yang ditentukan. Kesalahan ini dikembalikan jika antarmuka jaringan LUID atau indeks antarmuka yang ditentukan oleh anggota InterfaceLuid atau InterfaceIndexdari MIB_IF_ROW2 yang ditunjukkan oleh parameter Baris bukan nilai pada komputer lokal.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika parameter NULL diteruskan dalam parameter Baris . Kesalahan ini juga dikembalikan jika anggota InterfaceLuid dan InterfaceIndexdari MIB_IF_ROW2 yang ditunjukkan oleh parameter Baris tidak ditentukan.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

The
Fungsi GetIfEntry2Ex mengambil informasi untuk antarmuka tertentu pada sistem lokal dan mengembalikan informasi ini dalam pointer ke
MIB_IF_ROW2 struktur. GetIfEntry2Ex adalah versi fungsi GetIfEntry2 yang disempurnakan yang memungkinkan pemilihan tingkat informasi antarmuka untuk diambil.

Pada input, setidaknya salah satu anggota berikut dalam struktur MIB_IF_ROW2 yang diteruskan dalam parameter Baris harus diinisialisasi: InterfaceLuid atau InterfaceIndex.

Bidang digunakan dalam urutan yang tercantum di atas. Jadi, jika InterfaceLuid ditentukan, maka anggota ini digunakan untuk menentukan antarmuka. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), maka anggota InterfaceIndex berikutnya digunakan untuk menentukan antarmuka.

Pada output, bidang yang tersisa dari struktur MIB_IF_ROW2 yang ditunjukkan oleh parameter Baris diisi.

Perhatikan bahwa file header Netioapi.h secara otomatis disertakan dalam file header Iphlpapi.h , dan tidak boleh digunakan secara langsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1703 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	netioapi.h (termasuk Iphlpapi.h)
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll