Aracılığıyla paylaş


GetInvertedIfStackTable işlevi

GetInvertedIfStackTable işlevi, bir arabirim yığınındaki ağ arabirimlerinin ilişkisini belirten ters ağ arabirimi yığın satırı girdilerinden oluşan bir tablo alır.

Sözdizimi

NETIOAPI_API GetInvertedIfStackTable(
  _Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);

Parametre

  • Tablo [out]
    bir MIB_INVERTEDIFSTACK_TABLE yapısında ters arabirim yığını satır girişlerinin tablosunu alan bir arabelleğe yönelik işaretçi.

Dönüş değeri

getInvertedIfStackTable işlevi başarılı olursa STATUS_SUCCESS döndürür.

İşlev başarısız olursa GetInvertedIfStackTable aşağıdaki hata kodlarından birini döndürür:

İade kodu Açıklama
STATUS_INVALID_PARAMETER

İşleve geçersiz bir parametre geçirildi. Tablo parametresinde NULL işaretçisi geçirilirse bu hata döndürülür.

STATUS_NOT_ENOUGH_MEMORY

İşlemi tamamlamak için yeterli bellek kaynağı yok.

STATUS_NOT_FOUND

Arabirim yığını girdisi bulunamadı.

Diğer

Döndürülen hatanın ileti dizesini almak için FormatMessage işlevini kullanın.

Açıklamalar

GetInvertedIfStackTable işlevi, yerel bilgisayardaki bir arabirim yığınındaki fiziksel ve mantıksal ağ arabirimlerini numaralandırır ve bu bilgileri MIB_INVERTEDIFSTACK_TABLE yapısında ters bir biçimde döndürür.

GetInvertedIfStackTable, Tablo parametresinin işaret MIB_INVERTEDIFSTACK_TABLE bir yapıdaki arabirim yığını girdilerini arabellekte döndürür. MIB_INVERTEDIFSTACK_TABLE yapısı bir arabirim yığını giriş sayısı ve her arabirim yığını girişi için bir dizi MIB_INVERTEDIFSTACK_ROW yapısı içerir.

Arabirim yığınındaki arabirimler arasındaki ilişki, MIB_INVERTEDIFSTACK_ROW yapısının HigherLayerInterfaceIndex üyesinde dizine sahip arabirimin, MIB_INVERTEDIFSTACK_ROW yapısının üyesi LowerLayerInterfaceIndex dizinine sahip arabirimin hemen üzerinde olmasıdır.

GetInvertedIfStackTable, MIB_INVERTEDIFSTACK_TABLE yapısı ve bu yapıdaki MIB_INVERTEDIFSTACK_ROW girişleri için bellek ayırır. Döndürülen bu yapılar artık gerekli olmadığında, sürücünüz FreeMibTableçağırarak belleği boşaltmalıdır.

Tablo parametresinin işaret olduğu döndürülen MIB_INVERTEDIFSTACK_TABLE yapısının, NumEntries üyesi ile Tablo MIB_INVERTEDIFSTACK_TABLE yapısının ilk MIB_INVERTEDIFSTACK_ROW dizi girişi arasında hizalama için doldurma içerebileceğini unutmayın. Hizalama için doldurma, MIB_INVERTEDIFSTACK_ROW dizi girdileri arasında da bulunabilir. MIB_INVERTEDIFSTACK_ROW dizi girişine yapılan tüm erişimlerde doldurmanın mevcut olabileceği varsayılmalıdır.

Gereksinim -leri

Hedef platform

Evrensel

Sürüm

Windows Vista ve Windows işletim sistemlerinin sonraki sürümlerinde kullanılabilir.

Üstbilgi

Netioapi.h (Netioapi.h içerir)

Kütüphane

Netio.lib

IRQL

< DISPATCH_LEVEL

Ayrıca bkz.

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