SetIpNetEntry2-Funktion

Artikel
03/13/2025

Die SetIpNetEntry2--Funktion legt die physische Adresse eines vorhandenen Ip-Adresseintrags eines vorhandenen Nachbarn 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 Ip-Adresseintrag des Nachbarn.

Rückgabewert

SetIpNetEntry2 STATUS_SUCCESS zurückgeben, wenn die Funktion erfolgreich ist.

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

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	An die Funktion wurde ein ungültiger Parameter übergeben. Dieser Fehler wird in den folgenden Situationen zurückgegeben. Ein NULL- Zeiger wurde im parameter Row übergeben. Das Address Member 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 PhysicalAddress und PhysicalAddressLength- Elemente der MIB_IPNET_ROW2-Struktur wurden nicht auf eine gültige physische Adresse festgelegt. Sowohl InterfaceLuid als auch InterfaceIndex Elemente der MIB_IPNET_ROW2 Struktur wurden nicht angegeben. Eine Loopbackadresse wurde im Address Member ü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 durch die 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 Address Member 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 Address Member angegeben wurde.
Andere	Verwenden Sie die FormatMessage--Funktion, um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Bemerkungen

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

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

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

Anforderungen

Zielplattform	universelle
Version	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfball	Netioapi.h (include Netioapi.h)
Bibliothek	Netio.lib
IRQL	< DISPATCH_LEVEL