CreateAnycastIpAddressEntry işlevi

CreateAnycastIpAddressEntry işlevi, yerel bilgisayara yeni bir anycast IP adresi girişi ekler.

Sözdizimi

NETIOAPI_API CreateAnycastIpAddressEntry(
  _In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);

Parametre

• Satır [in]
  Herhangi bir yayın IP adresi girişi için MIB_ANYCASTIPADDRESS_ROW yapı girdisine yönelik bir işaretçi.

Dönüş değeri

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

İşlev başarısız olursa CreateAnycastIpAddressEntry 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 tek noktaya yayın IPv4 veya IPv6 adresine ayarlanmamış ya da MIB_ANYCASTIPADDRESS_ROW yapısının hem InterfaceLuid hem de 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_ANYCASTIPADDRESS_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.
ERROR_OBJECT_ALREADY_EXISTS	Nesne zaten var. Satırı parametresinin işaret ettiği MIB_ANYCASTIPADDRESS_ROW yapısının Adresi üyesi, MIB_ANYCASTIPADDRESS_ROW yapısının InterfaceLuid veya InterfaceIndex üyesi tarafından belirtilen arabirimdeki herhangi bir yayın IP adresinin yinelemesiyse 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_ANYCASTIPADDRESS_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, bu üye tek noktaya yayın IP adresinin ekleneceği arabirimi belirlemek için 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şaret MIB_ANYCASTIPADDRESS_ROW yapısının ScopeId üyesi, CreateAnycastIpAddressEntry işlevi çağrıldığında yoksayılır. ScopeId üyesi, adresin eklendiği arabirim tarafından otomatik olarak belirlenir.

createAnycastIpAddressEntry işlevi, Satırı parametresinin işaret MIB_ANYCASTIPADDRESS_ROW yapısının Adresi üyesine geçirilen herhangi bir yayın IP adresinin arabirimdeki mevcut herhangi bir IP adresinin yinelemesi olması durumunda 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.

DeleteAnycastIpAddressEntry

GetAnycastIpAddressEntry

GetAnycastIpAddressTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE