Fungsi GetIfEntry2
Fungsi GetIfEntry2 mengambil informasi untuk antarmuka yang ditentukan di komputer lokal.
Penting
Untuk pengembang driver, disarankan untuk menggunakan GetIfEntry2Ex dengan MibIfEntryNormalWithoutStatistics jika memungkinkan, untuk menghindari kebuntuan saat melayani OID NDIS.
Sintaksis
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Parameter
-
Baris [masuk, keluar]
Penunjuk ke struktur MIB_IF_ROW2 yang, pada pengembalian berhasil, menerima informasi untuk antarmuka di komputer lokal. Pada input, driver Anda harus mengatur anggota InterfaceLuid atau anggota InterfaceIndex struktur MIB_IF_ROW2 ke antarmuka untuk mengambil informasi.
Mengembalikan nilai
GetIfEntry2 mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetIfEntry2 mengembalikan salah satu kode kesalahan berikut:
| Mengembalikan kode | Deskripsi |
|---|---|
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris. |
| STATUS_NOT_FOUND | Antarmuka yang ditentukan tidak dapat ditemukan. Kesalahan ini dikembalikan jika fungsi tidak dapat menemukan antarmuka jaringan yang ditentukan oleh InterfaceLuid atau InterfaceIndex anggota struktur MIB_IF_ROW2 yang ditunjuk oleh parameter Baris. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Komentar
Pada input, driver Anda harus menginisialisasi setidaknya InterfaceLuid atau InterfaceIndex anggota dalam struktur MIB_IF_ROW2 yang diteruskan dalam parameter Baris. Anggota digunakan dalam urutan yang tercantum sebelumnya. Jadi jika InterfaceLuid ditentukan, anggota ini digunakan untuk menentukan antarmuka. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.
Pada output, bidang yang tersisa dari struktur MIB_IF_ROW2 tempat parameter Baris diisi.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Perpustakaan |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |