SetIpNetEntry2-Funktion

Artikel
06/15/2023

Die SetIpNetEntry2-Funktion legt die physische Adresse eines vorhandenen Ip-Adresseintrags auf einem lokalen Computer fest.

Syntax

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

Parameter

Zeile [in]
Ein Zeiger auf einen MIB_IPNET_ROW2 Struktureintrag für einen benachbarten IP-Adresseintrag.

Rückgabewert

SetIpNetEntry2 gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.

Wenn die Funktion fehlschlägt, gibt SetIpNetEntry2 einen der folgenden Fehlercodes zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird in den folgenden Situationen zurückgegeben. Im Row-Parameter wurde ein NULL-Zeiger übergeben. Das Address-Element der MIB_IPNET_ROW2 Struktur, auf die der Row-Parameter verweist, wurde nicht auf eine gültige Unicast-, Anycast- oder Multicast-IPv4- oder IPv6-Adresse festgelegt. Die Member PhysicalAddress und PhysicalAddressLength der MIB_IPNET_ROW2-Struktur wurden nicht auf eine gültige physische Adresse festgelegt. Sowohl InterfaceLuid - als auch InterfaceIndex-Member der MIB_IPNET_ROW2-Struktur wurden nicht angegeben. Im Adresselement wurde eine Loopbackadresse übergeben.
STATUS_NOT_FOUND	Die angegebene Schnittstelle konnte nicht gefunden werden. Dieser Fehler wird zurückgegeben, wenn die Funktion die Netzwerkschnittstelle nicht finden kann, die vom InterfaceLuid- oder InterfaceIndex-Member der MIB_IPNET_ROW2 Struktur angegeben wird, auf die der Row-Parameter verweist.
STATUS_NOT_SUPPORTED	Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich kein IPv4-Stapel auf dem lokalen Computer befindet und eine IPv4-Adresse im Adresselement der MIB_IPNET_ROW2-Struktur angegeben wurde, auf die der Row-Parameter verweist, oder wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet und eine IPv6-Adresse im Adresselement angegeben wurde.
Andere	Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Bemerkungen

Ihr Treiber muss die folgenden Elemente der MIB_IPNET_ROW2-Struktur initialisieren, auf die der Row-Parameter verweist.

Adresse
Legen Sie auf eine gültige Unicast-, Anycast- oder Multicast-IPv4- oder IPv6-Adresse und -Familie fest.
PhysicalAddress und PhysicalAddressLength
Legen Sie auf eine gültige physische Adresse fest.
InterfaceLuid oder InterfaceIndex
Diese Member werden in der zuvor aufgeführten Reihenfolge verwendet. Wenn also InterfaceLuid angegeben ist, wird dieses Element verwendet, um die Schnittstelle zu bestimmen. Wenn kein Wert für das InterfaceLuid-Element festgelegt wurde (der Wert dieses Members wurde auf Null festgelegt), wird das InterfaceIndex-Element als nächstes verwendet, um die Schnittstelle zu bestimmen.

Die SetIpNetEntry2-Funktion schlägt fehl, wenn die IP-Adresse, die im Adresselement der MIB_IPNET_ROW2 Struktur übergeben wird, auf die der Row-Parameter verweist, keine vorhandene benachbarte IP-Adresse auf der angegebenen Schnittstelle ist.

Anforderungen

Zielplattform	Universell
Version	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header	Netioapi.h (einschließlich Netioapi.h)
Bibliothek	Netio.lib
IRQL	< DISPATCH_LEVEL