GetIpNetEntry2 işlevi

GetIpNetEntry2 işlevi, yerel bilgisayardaki bir komşu IP adresi girdisinin bilgilerini alır.

Sözdizimi

NETIOAPI_API GetIpNetEntry2(
  _Inout_ PMIB_IPNET_ROW2 Row
);

Parametre

• Satır [in, out]
  Komşu IP adresi girdisi için MIB_IPNET_ROW2 yapı girdisine yönelik bir işaretçi. Başarılı dönüşte, bu yapı komşu IP adresinin özellikleriyle güncelleştirilir.

Dönüş değeri

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

İşlev başarısız olursa GetIpNetEntry2 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 bir NULL işaretçisi geçirilirse bu hata döndürülür. Satırı parametresinin işaretdiği MIB_IPNET_ROW2 yapısının üyesinin Adresi geçerli bir komşu IPv4 veya IPv6 adresine ayarlanmamış ya da MIB_IPNET_ROW2 yapısının hem InterfaceLuid hem de InterfaceIndex üyeleri belirtilmemişti.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Satır parametresinin işaret ettiği MIB_IPNET_ROW2 yapısının InterfaceLuid veya InterfaceIndex üyesi tarafından belirtilen ağ arabirimini bulamazsa bu hata döndürülür.
STATUS_NOT_SUPPORTED	İstek desteklenmiyor. Yerel bilgisayarda IPv4 yığını yoksa ve Satırı parametresinin işaret MIB_IPNET_ROW2 yapısının Adresi üyesinde bir IPv4 adresi belirtildiyse veya yerel bilgisayarda IPv6 yığını yoksa ve Adresi üyesinde bir IPv6 adresi belirtildiyse 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

GetIpNetEntry2 işlevi, MIB_IPNET_ROW2 yapı girdisini almak için kullanılır.

Girişte, sürücünüz Satırı parametresinin işaret MIB_IPNET_ROW2 yapısının aşağıdaki üyelerini başlatmalıdır.

• Adresi
  Geçerli bir komşu IPv4 veya IPv6 adresi ve ailesi olarak ayarlayın.

• InterfaceLuid veya InterfaceIndex
  Bu ü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, çağrı başarılı olduğunda GetIpNetEntry2 komşu IP adresinin diğer özelliklerini alır ve Satırı parametresinin işaret MIB_IPNET_ROW2 yapısını doldurur.

Sürücünüz, yerel bilgisayarda komşu IP adresi girdilerini listelemek için getipnettable2işleviniçağırabilir.

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.

GetIpNetTable2

MIB_IPNET_ROW2