Fungsi GetInvertedIfStackTable (netioapi.h)

Artikel
08/25/2023

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

Sintaks

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetInvertedIfStackTable(
  [out] PMIB_INVERTEDIFSTACK_TABLE *Table
);

Parameter

[out] Table

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

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
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 GetInvertedIfStackTable didefinisikan pada Windows Vista dan yang lebih baru.

The
Fungsi GetInvertedIfStackTable menghitung antarmuka jaringan fisik dan logis pada tumpukan antarmuka pada sistem lokal dan mengembalikan informasi ini dalam bentuk terbalik dalam struktur MIB_INVERTEDIFSTACK_TABLE .

Entri tumpukan antarmuka dikembalikan dalam struktur MIB_INVERTEDIFSTACK_TABLE dalam buffer yang ditunjukkan oleh parameter Tabel . Struktur MIB_INVERTEDIFSTACK_TABLE berisi jumlah entri tumpukan antarmuka dan array struktur MIB_INVERTEDIFSTACK_ROW untuk setiap entri tumpukan antarmuka.

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

Memori dialokasikan oleh fungsi GetInvertedIfStackTable untuk struktur MIB_INVERTEDIFSTACK_TABLE dan entri MIB_INVERTEDIFSTACK_ROW dalam struktur ini. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, kosongkan memori dengan memanggil FreeMibTable.

Perhatikan bahwa struktur MIB_INVERTEDIFSTACK_TABLE yang dikembalikan yang diarahkan oleh parameter Tabel mungkin berisi pengisi untuk perataan antara anggota NumEntries dan entri array MIB_INVERTEDIFSTACK_ROW pertama di anggota Tabel dari struktur MIB_INVERTEDIFSTACK_TABLE . Padding untuk perataan mungkin juga ada di antara entri array MIB_INVERTEDIFSTACK_ROW . Setiap akses ke entri array MIB_INVERTEDIFSTACK_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