Fungsi GetIfStackTable (netioapi.h)

Artikel
03/09/2024

Fungsi GetIfStackTable mengambil tabel entri baris tumpukan antarmuka jaringan yang menentukan hubungan antarmuka jaringan pada tumpukan antarmuka.

Sintaks

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfStackTable(
  [out] PMIB_IFSTACK_TABLE *Table
);

Parameter

[out] Table

Penunjuk ke buffer yang menerima tabel entri baris tumpukan antarmuka dalam struktur MIB_IFSTACK_TABLE .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Tabel .
ERROR_NOT_ENOUGH_MEMORY	Sumber daya memori tidak cukup tersedia untuk menyelesaikan operasi.
ERROR_NOT_FOUND	Tidak ada entri tumpukan antarmuka yang ditemukan.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi GetIfStackTable ditentukan pada Windows Vista dan yang lebih baru.

The
Fungsi GetIfStackTable menghitung antarmuka jaringan fisik dan logis pada tumpukan antarmuka pada sistem lokal dan mengembalikan informasi ini dalam struktur MIB_IFSTACK_TABLE .

Entri tumpukan antarmuka dikembalikan dalam struktur MIB_IFSTACK_TABLE dalam buffer yang diacu oleh parameter Tabel . Struktur MIB_IFSTACK_TABLE berisi jumlah entri tumpukan antarmuka dan array struktur MIB_IFSTACK_ROW untuk setiap entri tumpukan antarmuka.

Hubungan antara antarmuka dalam tumpukan antarmuka adalah bahwa antarmuka dengan indeks di anggota HigherLayerInterfaceIndex dari struktur MIB_IFSTACK_ROW tepat di atas antarmuka dengan indeks di anggota LowerLayerInterfaceIndex dari struktur MIB_IFSTACK_ROW .

Memori dialokasikan oleh fungsi GetIfStackTable untuk struktur MIB_IFSTACK_TABLE dan entri MIB_IFSTACK_ROW dalam struktur ini. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, kosongkan memori dengan memanggil FreeMibTable.

Perhatikan bahwa struktur MIB_IFSTACK_TABLE yang dikembalikan yang ditunjukkan oleh parameter Tabel mungkin berisi padding untuk perataan antara anggota NumEntries dan entri array MIB_IFSTACK_ROW pertama di anggota Tabel dari struktur MIB_IFSTACK_TABLE . Padding untuk perataan mungkin juga ada di antara entri array MIB_IFSTACK_ROW . Akses apa pun ke entri array MIB_IFSTACK_ROW 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