SetIpNetEntry2 işlevi

SetIpNetEntry2 işlevi, yerel bilgisayardaki mevcut bir komşu IP adresi girişinin fiziksel adresini ayarlar.

Sözdizimi

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Parametre

• Satır [in]
  Komşu IP adresi girdisi için MIB_IPNET_ROW2 yapı girdisine yönelik bir işaretçi.

Dönüş değeri

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

İşlev başarısız olursa SetIpNetEntry2 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. Bu hata aşağıdaki durumlarda döndürülür. Satırı parametresinde NULL işaretçisi geçirildi. Satırı parametresinin işaret MIB_IPNET_ROW2 yapısının Adresi üyesi geçerli bir tek noktaya yayın, herhangi bir yayın veya çok noktaya yayın IPv4 veya IPv6 adresine ayarlanmadı. MIB_IPNET_ROW2 yapısının PhysicalAddress ve PhysicalAddressLength üyeleri geçerli bir fiziksel adrese ayarlanmadı. MIB_IPNET_ROW2 yapısının hem InterfaceLuid hem de InterfaceIndex üyeleri belirtilmemişti. Adresi üyesine geri döngü adresi geçirildi.
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

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 tek noktaya yayın, herhangi bir yayın veya çok noktaya yayın IPv4 veya IPv6 adresi ve ailesi olarak ayarlayın.

• PhysicalAddress ve PhysicalAddressLength
  Geçerli bir fiziksel adrese 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.

SetIpNetEntry2 işlevi, Satırı parametresinin işaret MIB_IPNET_ROW2 yapısının Adresi üyesine geçirilen IP adresi belirtilen arabirimde var olan bir komşu IP adresi değilse 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.

CreateIpNetEntry2

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2