Fungsi GetIfTable2
Fungsi GetIfTable2 mengambil tabel antarmuka MIB-II.
Sintaks
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Parameter
- Tabel [keluar]
Penunjuk ke buffer yang menerima tabel antarmuka dalam struktur MIB_IF_TABLE2 .
Mengembalikan nilai
GetIfTable2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetIfTable2 mengembalikan salah satu kode kesalahan berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_NOT_ENOUGH_MEMORY | Sumber daya memori tidak cukup tersedia untuk menyelesaikan operasi. |
Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi GetIfTable2 menghitung antarmuka logis dan fisik di komputer lokal dan mengembalikan informasi ini dalam struktur MIB_IF_TABLE2 .
Driver Anda dapat menggunakan fungsi serupa, GetIfTable2Ex, untuk menentukan tingkat antarmuka yang akan dikembalikan. Panggilan ke fungsi GetIfTable2Ex dengan parameter Tingkat yang diatur ke MibIfTableNormal mengambil hasil yang sama seperti memanggil fungsi GetIfTable2 .
GetIfTable2 mengembalikan antarmuka dalam struktur MIB_IF_TABLE2 dalam buffer yang diunjukkan parameter Tabel . Struktur MIB_IF_TABLE2 berisi jumlah antarmuka dan array struktur MIB_IF_ROW2 untuk setiap antarmuka. GetIfTable2 mengalokasikan memori untuk struktur MIB_IF_TABLE2 dan entri MIB_IF_ROW2 dalam struktur ini. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, driver Anda harus membebaskan memori dengan memanggil FreeMibTable.
Perhatikan bahwa struktur MIB_IF_TABLE2 yang dikembalikan yang ditunjuk parameter Tabel mungkin berisi padding 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. Akses apa pun ke entri array MIB_IF_ROW2 harus mengasumsikan padding mungkin ada.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Pustaka |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |