GetIfStackTable işlevi

GetIfStackTable işlevi, bir arabirim yığınındaki ağ arabirimlerinin ilişkisini belirten bir ağ arabirimi yığını satır girdileri tablosu alır.

Sözdizimi

NETIOAPI_API GetIfStackTable(
  _Out_ PMIB_IFSTACK_TABLE *Table
);

Parametre

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

Dönüş değeri

GetIfStackTable, işlev başarılı olursa STATUS_SUCCESS döndürür.

İşlev başarısız olursa GetIfStackTable 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

GetIfStackTable işlevi, yerel bilgisayardaki bir arabirim yığınındaki fiziksel ve mantıksal ağ arabirimlerini numaralandırır ve bu bilgileri MIB_IFSTACK_TABLE bir yapıda döndürür.

Arabirim yığını girişleri, Tablo parametresinin işaret olduğu arabellekteki MIB_IFSTACK_TABLE bir yapıda döndürülür. MIB_IFSTACK_TABLE yapısı bir arabirim yığını giriş sayısı ve her arabirim yığını girişi için bir dizi MIB_IFSTACK_ROW yapısı içerir.

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

Bellek, MIB_IFSTACK_TABLE yapısı ve bu yapıdaki MIB_IFSTACK_ROW girişleri için GetIfStackTable işlevi tarafından ayrılı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_IFSTACK_TABLE yapısının, NumEntries üyesi ile Tablo MIB_IFSTACK_TABLE yapısının ilk MIB_IFSTACK_ROW dizi girişi arasında hizalama için doldurma içerebileceğini unutmayın. Hizalama için doldurma, MIB_IFSTACK_ROW dizi girişleri arasında da bulunabilir. MIB_IFSTACK_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

GetIfTable2

GetInvertedIfStackTable

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