De functie SetIpNetEntry2

Artikel
2025-03-13

Met de functie SetIpNetEntry2 wordt het fysieke adres van een bestaande IP-adresvermelding ingesteld op een lokale computer.

Syntaxis

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Parameters

rij [in]
Een aanwijzer naar een MIB_IPNET_ROW2 structuurvermelding voor een IP-adresvermelding van een buur.

Retourwaarde

SetIpNetEntry2 STATUS_SUCCESS retourneren als de functie slaagt.

Als de functie mislukt, retourneert SetIpNetEntry2 een van de volgende foutcodes:

Retourcode	Beschrijving
STATUS_INVALID_PARAMETER	Er is een ongeldige parameter doorgegeven aan de functie. Deze fout wordt geretourneerd in de volgende situaties. Er is een NULL- aanwijzer doorgegeven in de parameter Rij. Het -adres lid van de MIB_IPNET_ROW2-structuur waarnaar de parameter rij verwijst, is niet ingesteld op een geldig unicast-, anycast- of multicast-IPv4- of IPv6-adres. De PhysicalAddress en PhysicalAddressLength leden van de MIB_IPNET_ROW2-structuur zijn niet ingesteld op een geldig fysiek adres. Zowel InterfaceLuid als InterfaceIndex leden van de MIB_IPNET_ROW2-structuur waren niet opgegeven. Er is een loopback-adres doorgegeven in het -adres lid.
STATUS_NOT_FOUND	Kan de opgegeven interface niet vinden. Deze fout wordt geretourneerd als de functie de netwerkinterface die is opgegeven door de InterfaceLuid- of InterfaceIndex lid van de MIB_IPNET_ROW2-structuur waarnaar de parameter Row verwijst, niet kan vinden.
STATUS_NOT_SUPPORTED	De aanvraag wordt niet ondersteund. Deze fout wordt geretourneerd als er geen IPv4-stack zich op de lokale computer bevindt en er een IPv4-adres is opgegeven in het -adres lid van de MIB_IPNET_ROW2 structuur waarnaar de rij- parameter verwijst, of als er geen IPv6-stack op de lokale computer staat en er een IPv6-adres is opgegeven in het adres lid.
Overige	Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen.

Opmerkingen

Uw stuurprogramma moet de volgende leden van de MIB_IPNET_ROW2-structuur initialiseren waarnaar de rij- parameter verwijst.

adres
Ingesteld op een geldig unicast-, anycast- of multicast-IPv4- of IPv6-adres en -gezin.
PhysicalAddress en PhysicalAddressLength
Ingesteld op een geldig fysiek adres.
InterfaceLuid of InterfaceIndex
Deze leden worden gebruikt in de volgorde die eerder wordt vermeld. Dus als InterfaceLuid- is opgegeven, wordt dit lid gebruikt om de interface te bepalen. Als er geen waarde is ingesteld voor het InterfaceLuid lid (de waarde van dit lid is ingesteld op nul), wordt de InterfaceIndex lid naast het bepalen van de interface gebruikt.

De functie SetIpNetEntry2 mislukt als het IP-adres dat wordt doorgegeven in het -adres lid van de MIB_IPNET_ROW2-structuur waarnaar de parameter rij verwijst, geen bestaand ip-adres van de buur is op de opgegeven interface.

Eisen

Doelplatform	Universal
Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Rubriek	Netioapi.h (inclusief Netioapi.h)
Bibliotheek	Netio.lib
IRQL	< DISPATCH_LEVEL