GetIfTable2 işlevi

GetIfTable2 işlevi MIB-II arabirim tablosunu alır.

Sözdizimi

NETIOAPI_API GetIfTable2(
  _Out_ PMIB_IF_TABLE2 *Table
);

Parametre

• Tablo [out]
  MIB_IF_TABLE2 bir yapıda arabirimler tablosunu alan bir arabelleğe yönelik işaretçi.

Dönüş değeri

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

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

İade kodu	Açıklama
STATUS_NOT_ENOUGH_MEMORY	İşlemi tamamlamak için yeterli bellek kaynağı yok.
Diğer	Döndürülen hatanın ileti dizesini almak için FormatMessage işlevini kullanın.

Açıklamalar

GetIfTable2 işlevi, yerel bilgisayardaki mantıksal ve fiziksel arabirimleri numaralandırır ve bu bilgileri MIB_IF_TABLE2 bir yapıda döndürür.

Sürücünüz, döndürülecek arabirim düzeyini belirtmek için GetIfTable2Exbenzer bir işlev kullanabilir. Düzeyi parametresi mibIfTableNormal olarak ayarlanmış GetIfTable2Ex işlevi ne yapılan çağrı, GetIfTable2 işlevini çağırmayla aynı sonuçları alır.

GetIfTable2, Tablo parametresinin işaret olduğu arabellekteki MIB_IF_TABLE2 bir yapıdaki arabirimleri döndürür. MIB_IF_TABLE2 yapısı bir arabirim sayısı ve her arabirim için bir dizi MIB_IF_ROW2 yapısı içerir. GetIfTable2, MIB_IF_TABLE2 yapısı ve bu yapıdaki MIB_IF_ROW2 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_IF_TABLE2 yapısının, NumEntries üyesi ile Tablo MIB_IF_TABLE2 yapısının ilk MIB_IF_ROW2 dizi girişi arasında hizalama için doldurma içerebileceğini unutmayın. Hizalama için doldurma, MIB_IF_ROW2 dizi girişleri arasında da bulunabilir. MIB_IF_ROW2 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

GetIfTable2Ex

MIB_IF_TABLE2

MIB_IF_ROW2