CreateIpNetEntry2 işlevi

CreateIpNetEntry2 işlevi, yerel bilgisayarda yeni bir komşu IP adresi girişi oluşturur.

Sözdizimi

NETIOAPI_API CreateIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

Parametre

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

Dönüş değeri

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

İşlev başarısız olursa CreateIpNetEntry2 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. Aşağıdaki öğelerden biri oluşursa bu hata döndürülür: Satırı parametresinde NULL işaretçisi geçirilir. 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ı'nın parametre işaret MIB_IPNET_ROW2 yapısının Adres ü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.
ERROR_OBJECT_ALREADY_EXISTS	Nesne zaten var. Satırı parametresinin işaret ettiği MIB_IPNET_ROW2 yapısının Adresi üyesi, MIB_IPNET_ROW2 yapısının InterfaceLuid veya InterfaceIndex üyesi tarafından belirtilen arabirimdeki mevcut komşu IP adresinin bir kopyasıysa 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 üyesini 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 üyelerini MIB_IPNET_ROW2 yapısında geçerli bir fiziksel adres olarak ayarlayın.

• InterfaceLuid veya InterfaceIndex arabiriminin LUID veya dizin değerine ayarlayın.

InterfaceLuid ve InterfaceIndex üyeleri 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.

CreateIpNetEntry2 işlevi, Satırı parametresinin işaret MIB_IPNET_ROW2 yapısının Adresi üyesine geçirilen IP adresi arabirimdeki mevcut bir komşu IP adresinin kopyasıysa 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.

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2

SetIpNetEntry2