Dela via

Funktionen CreateIpNetEntry2

Funktionen CreateIpNetEntry2 skapar en ny angränsande IP-adresspost på den lokala datorn.

Syntax

NETIOAPI_API CreateIpNetEntry2(
  _In_ const MIB_IPNET_ROW2 *Row
);

Parametrar

  • rad [in]
    En pekare till en MIB_IPNET_ROW2 strukturpost för en IP-vägpost.

Returvärde

CreateIpNetEntry2 returnerar STATUS_SUCCESS om funktionen lyckas.

Om funktionen misslyckas returnerar CreateIpNetEntry2 någon av följande felkoder:

Returnera kod Beskrivning
STATUS_INVALID_PARAMETER

En ogiltig parameter skickades till funktionen. Det här felet returneras om något av följande inträffar:

  • En NULL- pekare skickas i parametern Rad.

  • -adressen medlem i den MIB_IPNET_ROW2 struktur som rad parametern pekar på inte har angetts till en giltig unicast-, anycast- eller multicast-IPv4- eller IPv6-adress.

  • PhysicalAddress och PhysicalAddressLength medlemmar i MIB_IPNET_ROW2-strukturen har inte angetts till en giltig fysisk adress.

  • Både InterfaceLuid och InterfaceIndex medlemmar i den MIB_IPNET_ROW2 strukturen var ospecificerade.

  • En loopback-adress skickades i -adressen medlem.
STATUS_NOT_FOUND

Det gick inte att hitta det angivna gränssnittet. Det här felet returneras om funktionen inte kan hitta nätverksgränssnittet som anges av InterfaceLuid eller InterfaceIndex medlem i den MIB_IPNET_ROW2 struktur som Rad parameter pekar på.
STATUS_NOT_SUPPORTED

Begäran stöds inte. Det här felet returneras om ingen IPv4-stack finns på den lokala datorn och en IPv4-adress angavs i -adressen medlem i MIB_IPNET_ROW2 struktur som rad parameterpunkter, eller om ingen IPv6-stack finns på den lokala datorn och en IPv6-adress angavs i adress medlem.
ERROR_OBJECT_ALREADY_EXISTS

Objektet finns redan. Det här felet returneras om adressen medlem i den MIB_IPNET_ROW2 struktur som rad parametern pekar på är en dubblett av en befintlig grannes IP-adress i gränssnittet som anges av InterfaceLuid eller InterfaceIndex medlem i MIB_IPNET_ROW2-strukturen.
Andra

Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet.

Anmärkningar

Drivrutinen måste initiera följande medlemmar i den MIB_IPNET_ROW2 struktur som parametern Rad pekar på:

  • Ange -adressen medlem till en giltig unicast-, anycast- eller multicast-IPv4- eller IPv6-adress och -familj.

  • Ange PhysicalAddress och PhysicalAddressLength medlemmar i MIB_IPNET_ROW2 struktur till en giltig fysisk adress.

  • Ange InterfaceLuid eller InterfaceIndex till LUID- eller indexvärdet för gränssnittet.

InterfaceLuid och InterfaceIndex medlemmar används i den ordning som anges tidigare. Så om InterfaceLuid anges används den här medlemmen för att fastställa gränssnittet för att lägga till unicast-IP-adressen på. Om inget värde har angetts för InterfaceLuid medlem (värdet för den här medlemmen har angetts till noll) används InterfaceIndex medlem för att fastställa gränssnittet.

Funktionen CreateIpNetEntry2 misslyckas om DEN IP-adress som skickas i -adressen medlem i den MIB_IPNET_ROW2 struktur som Rad parameter pekar på är en dubblett av en befintlig grannes IP-adress i gränssnittet.

Krav

Målplattform

 Universell

Version

Finns i Windows Vista och senare versioner av Windows-operativsystemen.

Rubrik

 Netioapi.h (inkludera Netioapi.h)

Bibliotek

 Netio.lib

IRQL

< DISPATCH_LEVEL

Se även

DeleteIpNetEntry2

FlushIpNetTable2

GetIpNetEntry2

GetIpNetTable2

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2

SetIpNetEntry2

  • Last updated on