GetIpPathEntry işlevi

GetIpPathEntry işlevi, yerel bilgisayardaki bir IP yolu girdisinin bilgilerini alır.

Sözdizimi

NETIOAPI_API GetIpPathEntry(
  _Inout_ PMIB_IPPATH_ROW Row
);

Parametre

• Satır [in, out]
  IP yolu girdisi için MIB_IPPATH_ROW yapı girdisine yönelik bir işaretçi. Başarılı dönüşte, bu yapı IP yolu girişinin özellikleriyle güncelleştirilir.

Dönüş değeri

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

İşlev başarısız olursa GetIpPathEntry 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, Satır parametresinin işaret MIB_IPPATH_ROW yapısının Hedef üyesi si_family üyesi AF_INET veya AF_INET6 olarak ayarlanmadıysa bu hata döndürülür. veya MIB_IPPATH_ROW yapısının InterfaceLuid ve InterfaceIndex üyeleri belirtilmemişti. MIB_IPPATH_ROW yapısının Kaynak üyesindeki si_family üyesi hedef IP adresi ailesi ile eşleşmediyse ve kaynak IP adresi için si_family AF_UNSPEC olarak belirtilmemişse de bu hata döndürülür.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Satırı parametresinin işaret ettiği MIB_IPPATH_ROW 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 Kaynak ve HedefSatırı'nın parametrenin işaretlendiği MIB_IPPATH_ROW yapısının üyelerinde bir IPv4 adresi belirtildiyse veya yerel bilgisayarda IPv6 yığını yoksa ve Kaynak ve Hedef üyelerinde 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

GetIpPathEntry işlevi, MIB_IPPATH_ROW yapı girdisi almak için kullanılır.

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

• hedef
  Geçerli bir IPv4 veya IPv6 adresi ve ailesi olarak ayarlayın.

• Kaynak
  Kaynak üyesinde belirtilen adres ailesini, Hedef üyesinde belirtilen hedef IP adresi ailesine veya AF_UNSPEC 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 GetIpPathEntry IP yolu girdisinin diğer özelliklerini alır ve Satırı parametresinin işaret MIB_IPPATH_ROW yapısını doldurur.

Sürücünüz, yerel bilgisayardaki IP yolu girdilerini listelemek için GetIpPathTable iş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.

FlushIpPathTable

GetIpPathTable

MIB_IPPATH_ROW

MIB_IPPATH_TABLE