Bagikan melalui


Fungsi GetInvertedIfStackTable

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

Sintaksis

NETIOAPI_API GetInvertedIfStackTable(
  _Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);

Parameter

  • Tabel [out]
    Penunjuk ke buffer yang menerima tabel entri baris tumpukan antarmuka terbalik dalam struktur MIB_INVERTEDIFSTACK_TABLE.

Mengembalikan nilai

GetInvertedIfStackTable mengembalikan STATUS_SUCCESS jika fungsi berhasil.

Jika fungsi gagal, GetInvertedIfStackTable mengembalikan salah satu kode kesalahan berikut:

Mengembalikan kode Deskripsi
STATUS_INVALID_PARAMETER

Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika pointer NULL diteruskan dalam parameter Tabel.

STATUS_NOT_ENOUGH_MEMORY

Sumber daya memori tidak cukup tersedia untuk menyelesaikan operasi.

STATUS_NOT_FOUND

Tidak ada entri tumpukan antarmuka yang ditemukan.

Lainnya

Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

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

GetInvertedIfStackTable mengembalikan entri tumpukan antarmuka dalam struktur MIB_INVERTEDIFSTACK_TABLE dalam buffer yang ditunjuk 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 HigherLayerInterfaceIndex anggota struktur MIB_INVERTEDIFSTACK_ROW berada tepat di atas antarmuka dengan indeks di LowerLayerInterfaceIndex anggota struktur MIB_INVERTEDIFSTACK_ROW.

GetInvertedIfStackTable mengalokasikan memori untuk struktur MIB_INVERTEDIFSTACK_TABLE dan entri MIB_INVERTEDIFSTACK_ROW dalam struktur ini. Ketika struktur yang dikembalikan ini tidak lagi diperlukan, driver Anda harus membebaskan memori dengan memanggil FreeMibTable.

Perhatikan bahwa struktur MIB_INVERTEDIFSTACK_TABLE yang dikembalikan yang ditunjukkan parameter Tabel mungkin berisi padding untuk perataan antara anggota NumEntries dan entri array MIB_INVERTEDIFSTACK_ROW pertama di Tabel anggota struktur MIB_INVERTEDIFSTACK_TABLE. Padding untuk perataan mungkin juga ada di antara entri array MIB_INVERTEDIFSTACK_ROW. Akses apa pun ke entri array MIB_INVERTEDIFSTACK_ROW harus mengasumsikan padding mungkin ada.

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

Lihat juga

FreeMibTable

GetIfEntry2

GetIfStackTable

GetIfTable2

GetIpInterfaceEntry

InitializeIpInterfaceEntry

MIB_IF_ROW2

MIB_IF_TABLE2

MIB_IFSTACK_ROW

MIB_IFSTACK_TABLE

MIB_INVERTEDIFSTACK_ROW

MIB_INVERTEDIFSTACK_TABLE

MIB_IPINTERFACE_ROW

NotifyIpInterfaceChange

SetIpInterfaceEntry