Fungsi GetIfEntry2

Artikel
04/05/2024

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.

Sintaks

NETIOAPI_API GetIfEntry2(
  _Inout_ PMIB_IF_ROW2 Row
);

Parameter

Baris [masuk, keluar]
Penunjuk ke struktur MIB_IF_ROW2 yang, saat berhasil dikembalikan, menerima informasi untuk antarmuka di komputer lokal. Pada input, driver Anda harus mengatur anggota InterfaceLuid atau anggota InterfaceIndex dari struktur MIB_IF_ROW2 ke antarmuka untuk mengambil informasi.

Nilai hasil

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 anggota InterfaceLuid atau InterfaceIndex dari struktur MIB_IF_ROW2 yang ditunjuk parameter Baris.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Pada input, driver Anda harus menginisialisasi setidaknya anggota InterfaceLuid atau InterfaceIndex 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 yang diisi oleh parameter Baris .

Persyaratan

Platform target	Universal
Versi	Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru.
Header	Netioapi.h (termasuk Netioapi.h)
Pustaka	Netio.lib
IRQL	< DISPATCH_LEVEL

Lihat juga

Bagikan melalui