GetIpForwardEntry2 işlevi

GetIpForwardEntry2 işlevi, yerel bilgisayardaki ip yolu girdisine ilişkin bilgileri alır.

Sözdizimi

NETIOAPI_API GetIpForwardEntry2(
  _Inout_ PMIB_IPFORWARD_ROW2 Row
);

Parametre

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

Dönüş değeri

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

İşlev başarısız olursa GetIpForwardEntry2 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. Aşağıdaki durumlardan biri oluşursa bu hata döndürülür: Satırı parametresinde NULL işaretçisi geçirilir. Satırı parametresinin işaret MIB_IPFORWARD_ROW2 yapısının DestinationPrefix üyesi belirtilmedi. MIB_IPFORWARD_ROW2 yapısının NextHop üyesi belirtilmedi. MIB_IPFORWARD_ROW2 yapısının hem InterfaceLuid hem de InterfaceIndex üyeleri belirtilmemişti. MIB_IPFORWARD_ROW2 yapısının PreferredLifetime üyesi, ValidLifetime üyesinden büyüktür. MIB_IPFORWARD_ROW2 yapısının SitePrefixLength üyesi, DestinationPrefix üyesi tarafından belirtilen ön ek uzunluğundan büyüktür.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Satırı parametresinin işaret ettiği MIB_IPFORWARD_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ı'nın işaret MIB_IPFORWARD_ROW2 yapısının DestinationPrefix üyesinde adres ailesinde AF_INET belirtildiyse veya yerel bilgisayarda IPv6 yığını yoksa ve DestinationPrefix üyesindeki adres ailesi için AF_INET6 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

GetIpForwardEntry2 işlevi, MIB_IPFORWARD_ROW2 yapı girdisini almak için kullanılır.

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

• DestinationPrefix
  Geçerli bir IPv4 veya IPv6 adres ön eki ve ailesi olarak ayarlayın.

• NextHop
  Geçerli bir 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 GetIpForwardEntry2 IP yolu girdisinin diğer özelliklerini alır ve Satırı parametresinin işaret MIB_IPFORWARD_ROW2 yapısını doldurur.

Satırı parametresinin işaret ettiği MIB_IPFORWARD_ROW2 yapısının Ölçümü üyesinde belirtilen yol ölçümü uzaklığı, tüm yol ölçümünün yalnızca bir bölümünü temsil eder. Tam ölçüm, ilişkili arabirimin MIB_IPINTERFACE_ROW yapısının Ölçümü üyesinde belirtilen arabirim ölçümüne eklenen bu yol ölçümünün bir bileşimidir. Sürücü, GetIpInterfaceEntry işlevini çağırarak arabirim ölçümünü alabilir.

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

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardTable2

GetIpInterfaceEntry

InitializeIpForwardEntry

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

MIB_IPINTERFACE_ROW

NotifyRouteChange2

SetIpForwardEntry2