GetUnicastIpAddressEntry işlevi

GetUnicastIpAddressEntry işlevi, yerel bilgisayardaki mevcut bir tek noktaya yayın IP adresi girdisine ilişkin bilgileri alır.

Sözdizimi

NETIOAPI_API GetUnicastIpAddressEntry(
  _Inout_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parametre

• Satır [in, out]
  Tek noktaya yayın IP adresi girişi için MIB_UNICASTIPADDRESS_ROW yapı girdisine yönelik bir işaretçi. Başarılı dönüşte, bu yapı mevcut bir tek noktaya yayın IP adresinin özellikleriyle güncelleştirilir.

Dönüş değeri

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

İşlev başarısız olursa GetUnicastIpAddressEntry 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 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 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

GetUnicastIpAddressEntry işlevi genellikle değiştirilecek mevcut bir MIB_UNICASTIPADDRESS_ROW yapısı girdisini almak için kullanılır. 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.

Girişte, 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.

Çıktıda, çağrı başarılı olduğunda GetUnicastIpAddressEntry tek noktaya yayın IP adresinin diğer özelliklerini alır ve Satırı parametresinin işaret MIB_UNICASTIPADDRESS_ROW yapısını doldurur.

Sürücünüz, yerel bilgisayardaki tek noktaya yayın IP adresi girdilerini listelemek için GetUnicastIpAddressTable 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.

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry