Fungsi GetIfTable2 (netioapi.h)
Fungsi GetIfTable2 mengambil tabel antarmuka MIB-II.
Sintaks
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfTable2(
[out] PMIB_IF_TABLE2 *Table
);
Parameter
[out] Table
Penunjuk ke buffer yang menerima tabel antarmuka dalam struktur MIB_IF_TABLE2 .
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 |
---|---|
|
Sumber daya memori tidak cukup tersedia untuk menyelesaikan operasi. |
|
Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
The
Fungsi GetIfTable2 menghitung antarmuka logis dan fisik pada sistem lokal dan mengembalikan informasi ini dalam struktur MIB_IF_TABLE2 .
GetIfTable2 adalah versi fungsi GetIfTable yang disempurnakan.
Fungsi GetIfTable2Ex serupa dapat digunakan untuk menentukan tingkat antarmuka yang akan dikembalikan. Memanggil fungsi GetIfTable2Ex dengan parameter Level yang diatur ke MibIfTableNormal mengambil hasil yang sama dengan memanggil fungsi GetIfTable2 .
Antarmuka dikembalikan dalam struktur MIB_IF_TABLE2 dalam buffer yang diacu oleh parameter Tabel . Struktur MIB_IF_TABLE2 berisi jumlah antarmuka dan array struktur MIB_IF_ROW2 untuk setiap antarmuka. Memori dialokasikan oleh fungsi GetIfTable2 untuk struktur MIB_IF_TABLE2 dan entri MIB_IF_ROW2 dalam struktur ini. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, kosongkan memori dengan memanggil FreeMibTable.
Perhatikan bahwa struktur MIB_IF_TABLE2 yang dikembalikan yang ditunjukkan oleh parameter Tabel mungkin berisi pengisi untuk perataan antara anggota NumEntries dan entri array MIB_IF_ROW2 pertama di anggota Tabel dari struktur MIB_IF_TABLE2 . Padding untuk perataan mungkin juga ada di antara entri array MIB_IF_ROW2 . Setiap akses ke entri array MIB_IF_ROW2 harus mengasumsikan padding mungkin ada.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | netioapi.h (termasuk Iphlpapi.h) |
Pustaka | Iphlpapi.lib |
DLL | Iphlpapi.dll |