GetIpNetEntry2-Funktion (netioapi.h)

Artikel
03/04/2024

Die GetIpNetEntry2-Funktion ruft Informationen für einen Benachbarten IP-Adresseintrag auf dem lokalen Computer ab.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIpNetEntry2(
  [in, out] PMIB_IPNET_ROW2 Row
);

Parameter

[in, out] Row

Ein Zeiger auf einen MIB_IPNET_ROW2 Struktureintrag für einen benachbarten IP-Adresseintrag. Bei erfolgreicher Rückgabe wird diese Struktur mit den Eigenschaften für die benachbarte IP-Adresse aktualisiert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_FILE_NOT_FOUND	Die angegebene Datei wurde nicht gefunden. Dieser Fehler wird zurückgegeben, wenn die NETZWERKschnittstellen-LUID oder der Schnittstellenindex, der vom InterfaceLuid- oder InterfaceIndex-Member des MIB_IPNET_ROW2 angegeben wurde, auf den der Row-Parameter verweist, kein Wert auf dem lokalen Computer war.
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Row-Parameter übergeben wird, das Address-Element des MIB_IPNET_ROW2 , auf das vom Row-Parameter verwiesen wird, nicht auf eine gültige benachbarte IPv4- oder IPv6-Adresse festgelegt wurde, oder die Elemente InterfaceLuid oder InterfaceIndex des MIB_IPNET_ROW2 nicht angegeben wurden, auf die vom Row-Parameter verwiesen wird.
ERROR_NOT_FOUND	Element wurde nicht gefunden. Dieser Fehler wird zurückgegeben, wenn die Netzwerkschnittstelle, die vom InterfaceLuid - oder InterfaceIndex-Member der MIB_IPNET_ROW2 Struktur angegeben wird, auf die der Row-Parameter verweist, nicht mit der benachbarten IP-Adresse und Adressfamilie übereinstimmt, die im Adresselement in der MIB_IPNET_ROW2-Struktur angegeben ist.
ERROR_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. Dieser Fehler wird auch zurückgegeben, wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet und eine IPv6-Adresse im Adresselement der MIB_IPNET_ROW2-Struktur angegeben wurde.
Andere	Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die GetIpNetEntry2-Funktion ist unter Windows Vista und höher definiert.

Die GetIpNetEntry2-Funktion wird verwendet, um einen MIB_IPNET_ROW2 Struktureintrag abzurufen.

Bei der Eingabe muss das Adresselement in der MIB_IPNET_ROW2 Struktur, auf die der Row-Parameter verweist, für eine gültige benachbarte IPv4- oder IPv6-Adresse und -Familie initialisiert werden. Darüber hinaus muss mindestens eines der folgenden Member in der MIB_IPNET_ROW2 Struktur initialisiert werden, die auf den Row-Parameter verweist: InterfaceLuid oder InterfaceIndex.

Die Felder werden in der oben aufgeführten Reihenfolge verwendet. Wenn also interfaceLuid angegeben wird, wird dieses Element verwendet, um die Schnittstelle zu bestimmen. Wenn kein Wert für das InterfaceLuid-Element festgelegt wurde (die Werte dieses Members wurden auf Null festgelegt), wird das InterfaceIndex-Element als nächstes verwendet, um die Schnittstelle zu bestimmen.

Bei der Ausgabe, wenn der Aufruf erfolgreich ist, ruft GetIpNetEntry2 die anderen Eigenschaften für die benachbarte IP-Adresse ab und füllt die MIB_IPNET_ROW2 Struktur aus, auf die der Row-Parameter verweist.

Die GetIpNetTable2-Funktion kann aufgerufen werden, um die Benachbarten IP-Adresseinträge auf einem lokalen Computer aufzulisten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll