SetUnicastIpAddressEntry işlevi

SetUnicastIpAddressEntry işlevi, yerel bilgisayardaki mevcut bir tek noktaya yayın IP adresi girişinin özelliklerini ayarlar.

Sözdizimi

NETIOAPI_API SetUnicastIpAddressEntry(
  _In_ const MIB_UNICASTIPADDRESS_ROW *Row
);

Parametre

• Satır [in]
  Var olan bir tek noktaya yayın IP adresi girişi için MIB_UNICASTIPADDRESS_ROW yapı girdisine yönelik bir işaretçi.

Dönüş değeri

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

İşlev başarısız olursa SetUnicastIpAddressEntry 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_UNICASTIPADDRESS_ROW yapısının Adresi üyesi geçerli bir tek noktaya yayın IPv4 veya IPv6 adresine ayarlanmamış ya da MIB_UNICASTIPADDRESS_ROW yapısının InterfaceLuid ve InterfaceIndex üyeleri belirtilmemişti.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Satırı parametresinin işaret ettiği MIB_UNICASTIPADDRESS_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 Satırı parametresinin işaret MIB_UNICASTIPADDRESS_ROW yapısının Adresi üyesinde bir IPv4 adresi belirtildiyse veya yerel bilgisayarda IPv6 yığını yoksa ve Adres ü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

GetUnicastIpAddressEntry işlevi genellikle değiştirilecek mevcut bir MIB_UNICASTIPADDRESS_ROW yapısı girdisini almak için kullanılır. Bir sürücü daha sonra değiştirmek istediği MIB_UNICASTIPADDRESS_ROW girdisindeki üyeleri değiştirebilir ve ardından SetUnicastIpAddressEntry işlevini çağırabilir.

Sürücü, değişiklik yapmadan önce MIB_UNICASTIPADDRESS_ROW yapı girişinin üyelerini varsayılan değerlerle başlatmak için InitializeUnicastIpAddressEntry işlevini çağırabilir. Ancak, sürücü genellikle InterfaceLuid veya InterfaceIndex üyesini InitializeUnicastIpAddressEntry çağırmadan önce kaydeder ve çağrıdan sonra bu üyelerden birini geri yükler.

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

• Adresi
  Geçerli bir tek noktaya yayın 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.

Satırı parametresinin işaretdiği MIB_UNICASTIPADDRESS_ROW yapısının OnLinkPrefixLength üyesi 255 olarak ayarlanırsa, SetUnicastIpAddressEntry tek noktaya yayın IP adresi özelliklerini OnLinkPrefixLength üyesinin IP adresinin uzunluğuna eşit olacak şekilde ayarlar. Tek noktaya yayın IPv4 adresi için OnLinkPrefixLength 32 olarak ayarlanır. Tek noktaya yayın IPv6 adresi için OnLinkPrefixLength 128 olarak ayarlanır. Bu ayarlar bir IPv4 adresi için yanlış alt ağ maskesine veya bir IPv6 adresi için yanlış bağlantı ön ekine neden olursa, sürücü SetUnicastIpAddressEntryçağırmadan önce bu üyeyi doğru değere ayarlamalıdır.

SetUnicastIpAddressEntry, DadState, ScopeIdve CreationTimeStampSatır parametresinin işaretdiği MIB_UNICASTIPADDRESS_ROW yapısının üyelerini yoksayar. Bu üyeler ağ yığını tarafından ayarlanır ve SetUnicastIpAddressEntry işlevi kullanılarak değiştirilemez. ScopeId üyesi, adresin eklendiği arabirim tarafından otomatik olarak belirlenir.

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.

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange