SetIpForwardEntry2 işlevi

SetIpForwardEntry2 işlevi, yerel bilgisayardaki ip yolu girişinin özelliklerini ayarlar.

Sözdizimi

NETIOAPI_API SetIpForwardEntry2(
  _In_ const MIB_IPFORWARD_ROW2 *Route
);

Parametre

• Rota [in]
  IP yolu girdisi için MIB_IPFORWARD_ROW2 yapı girdisine yönelik bir işaretçi. Sürücünüz, MIB_IPFORWARD_ROW2 yapısının DestinationPrefix üyesini geçerli bir IP hedef ön eki ve ailesi olarak ayarlamalı, MIB_IPFORWARD_ROW2 NextHop üyesini geçerli bir IP adresi ve aile olarak ayarlamalı ve InterfaceLuid üyesini veya MIB_IPFORWARD_ROW2 InterfaceIndex üyesini belirtmelidir.

Dönüş değeri

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

İşlev başarısız olursa SetIpForwardEntry2 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. Route parametresinde NULL işaretçisi geçirilirse, Route parametresinin işaretdiği MIB_IPFORWARD_ROW2 yapısının üyesi DestinationPrefix belirtilmemişse, MIB_IPFORWARD_ROW2 yapısının NextHop üyesi belirtilmemişse bu hata döndürülür veya MIB_IPFORWARD_ROW2 yapısının InterfaceLuid ve InterfaceIndex üyeleri belirtilmemişti.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Route 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.
Diğer	Döndürülen hatanın ileti dizesini almak için FormatMessage işlevini kullanın.

Açıklamalar

SetIpForwardEntry2 işlevi, yerel bilgisayarda var olan bir IP yolu girdisinin özelliklerini ayarlamak için kullanılır.

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.

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

SetIpForwardEntry2, Satırı parametresinin işaret MIB_IPFORWARD_ROW2 yapısının Yaş ve Origin üyelerini yoksayar. Bu üyeler ağ yığını tarafından ayarlanır ve SetIpForwardEntry2 işlevi kullanılarak değiştirilemez.

DestinationPrefix ve NextHopRoute parametresinin işaret MIB_IPFORWARD_ROW2 yapısının üyeleri belirtilen arabirimdeki bir IP yolu girişiyle eşleşmemesi durumunda SetIpForwardEntry2 işlevi başarısız olur.

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

GetIpForwardEntry2

GetIpForwardTable2

GetIpInterfaceEntry

InitializeIpForwardEntry

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

MIB_IPINTERFACE_ROW

NotifyRouteChange2