GetIfEntry2 işlevi

GetIfEntry2 işlevi, yerel bilgisayarda belirtilen arabirime ilişkin bilgileri alır.

Önemli

Sürücü geliştiricileri için, NDIS OID'lerine bakım yaparken kilitlenmeyi önlemek için mümkün olduğunda MibIfEntryNormalWithoutStatistics ile GetIfEntry2Ex kullanmanız önerilir.

Sözdizimi

NETIOAPI_API GetIfEntry2(
  _Inout_ PMIB_IF_ROW2 Row
);

Parametre

• Satır [in, out]
  Başarılı bir dönüşte yerel bilgisayardaki bir arabirim için bilgi alan bir MIB_IF_ROW2 yapısının işaretçisi. Girişte sürücünüzün InterfaceLuid üyesini veya MIB_IF_ROW2 yapısının InterfaceIndex üyesini bilgilerini almak üzere arabirime ayarlaması gerekir.

Dönüş değeri

GetIfEntry2 işlevin başarılı olup olmadığını STATUS_SUCCESS döndürür.

İşlev başarısız olursa GetIfEntry2 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. Satırı parametresinde NULL işaretçisi geçirilirse bu hata döndürülür.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Satır parametresinin işaret ettiği MIB_IF_ROW2 yapısının InterfaceLuid veya InterfaceIndex üyesi tarafından belirtilen ağ arabirimini bulamazsa bu hata döndürülür.
Diğer	Döndürülen hatanın ileti dizesini almak için FormatMessage işlevini kullanın.

Açıklamalar

Girişte, sürücünüzün Satır parametresinde geçirilen MIB_IF_ROW2 yapısında en az InterfaceLuid veya InterfaceIndex üyesini başlatması gerekir. Üyeler, daha önce listelenen sırayla kullanılır. Bu nedenle InterfaceLuid belirtilirse, arabirimi belirlemek için bu üye kullanılır. InterfaceLuid üyesi için değer ayarlanmadıysa (bu üyenin değeri sıfır olarak ayarlandı), arabirimi belirlemek için InterfaceIndex üyesi kullanılır.

Çıktıda, Satırı parametresinin işaret olduğu MIB_IF_ROW2 yapısının kalan alanları doldurulur.

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.

GetIfTable2

GetIfTable2Ex

MIB_IF_ROW2

MIB_IF_TABLE2