GetAnycastIpAddressEntry işlevi

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

Sözdizimi

NETIOAPI_API GetAnycastIpAddressEntry(
  _Inout_ PMIB_ANYCASTIPADDRESS_ROW Row
);

Parametre

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

Dönüş değeri

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

İşlev başarısız olursa GetAnycastIpAddressEntry 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_ANYCASTIPADDRESS_ROW yapısının Adresi üyesi geçerli bir herhangi bir yayın IPv4 veya IPv6 adresine ayarlanmamış ya da hem InterfaceLuid hem de InterfaceIndex MIB_ANYCASTIPADDRESS_ROW yapısının üyeleri belirtilmemişti.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Satırı parametresinin işaret ettiği MIB_ANYCASTIPADDRESS_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

GetAnycastIpAddressEntry işlevi, var olan bir MIB_ANYCASTIPADDRESS_ROW yapı girdisini almak için kullanılır.

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

• Adresi
  Geçerli bir IPv4 veya IPv6 herhangi bir yayın 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 GetAnycastIpAddressEntry herhangi bir yayın IP adresinin diğer özelliklerini alır ve Satırı parametresinin işaret MIB_ANYCASTIPADDRESS_ROW yapısını doldurur.

Sürücünüz GetAnycastIpAddressTable işlevini çağırarak yerel bilgisayardaki herhangi bir yayın IP adresi girdisini numaralandı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.

CreateAnycastIpAddressEntry

DeleteAnycastIpAddressEntry

GetAnycastIpAddressTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE