GetIpInterfaceEntry-Funktion (netioapi.h)

Artikel
08/25/2023

Die GetIpInterfaceEntry-Funktion ruft IP-Informationen für die angegebene Schnittstelle auf dem lokalen Computer ab.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIpInterfaceEntry(
  [in, out] PMIB_IPINTERFACE_ROW Row
);

Parameter

[in, out] Row

Ein Zeiger auf eine MIB_IPINTERFACE_ROW Struktur, die bei erfolgreicher Rückgabe Informationen für eine Schnittstelle auf dem lokalen Computer empfängt. Bei der Eingabe muss das InterfaceLuid- oder InterfaceIndex-Element des MIB_IPINTERFACE_ROW auf die Schnittstelle festgelegt werden, für die Informationen abgerufen werden sollen.

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_IPINTERFACE_ROW 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 im Row-Parameter ein NULL-Zeiger übergeben wird, das Family-Element des MIB_IPINTERFACE_ROW, auf das vom Row-Parameter verwiesen wird, nicht als AF_INET oder AF_INET6 angegeben wurde, oder wenn die InterfaceLuid- oder InterfaceIndex-Member des MIB_IPINTERFACE_ROW, auf das vom Row-Parameter verwiesen wird, nicht angegeben wurden.
ERROR_NOT_FOUND	Element wurde nicht gefunden. Dieser Fehler wird zurückgegeben, wenn die Netzwerkschnittstelle, die vom InterfaceLuid - oder InterfaceIndex-Member der MIB_IPINTERFACE_ROW-Struktur angegeben wird, auf die vom Row-Parameter verwiesen wird, nicht mit der IP-Adressfamilie übereinstimmt, die im Familienmitglied in der MIB_IPINTERFACE_ROW-Struktur angegeben ist.
Andere	Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

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

Bei der Eingabe muss das Familienmitglied in der MIB_IPINTERFACE_ROW Struktur, auf die vom Parameter Row verwiesen wird, entweder AF_INET oder AF_INET6 initialisiert werden. Darüber hinaus muss bei der Eingabe mindestens eines der folgenden Member in der MIB_IPINTERFACE_ROW-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 wird das InterfaceLuid-Element der MIB_IPINTERFACE_ROW Struktur ausgefüllt, auf die der Row-Parameter verweist, wenn der InterfaceIndex angegeben wurde. Die anderen Elemente MIB_IPINTERFACE_ROW Struktur, auf die der Row-Parameter verweist, werden ebenfalls ausgefüllt.

Die InitializeIpInterfaceEntry-Funktion muss verwendet werden, um die Felder eines MIB_IPINTERFACE_ROW Struktureintrags mit Standardwerten zu initialisieren. Eine Anwendung kann dann die Felder im MIB_IPINTERFACE_ROW Eintrag ändern, den sie ändern möchte, und dann die SetIpInterfaceEntry-Funktion aufrufen.

Ein nicht privilegierter gleichzeitiger Zugriff auf mehrere Netzwerke mit unterschiedlichen Sicherheitsanforderungen schafft eine Sicherheitslücke und ermöglicht es einer nicht privilegierten Anwendung, Daten versehentlich zwischen den beiden Netzwerken weiterzuspeichern. Ein typisches Beispiel ist der gleichzeitige Zugriff auf ein virtuelles privates Netzwerk (VPN) und das Internet. Windows Server 2003 und Windows XP verwenden ein schwaches Hostmodell, bei dem RAS einen solchen gleichzeitigen Zugriff verhindert, indem die Routenmetrik aller Standardrouten über andere Schnittstellen erhöht wird. Daher wird der gesamte Datenverkehr über die VPN-Schnittstelle weitergeleitet, was die andere Netzwerkkonnektivität beeinträchtigt.

Unter Windows Vista und höher wird standardmäßig ein starkes Hostmodell verwendet. Wenn eine Quell-IP-Adresse in der Routensuche mithilfe von GetBestRoute2 oder GetBestRoute angegeben wird, ist die Routensuche auf die Schnittstelle der Quell-IP-Adresse beschränkt. Die Änderung der Routenmetrik durch RAS hat keine Auswirkungen, da die Liste der potenziellen Routen nicht einmal die Route für die VPN-Schnittstelle enthält, wodurch Datenverkehr ins Internet zugelassen wird. Das DisableDefaultRoutes-Element des MIB_IPINTERFACE_ROW kann verwendet werden, um die Standardroute für eine Schnittstelle zu deaktivieren. Dieser Member kann als Sicherheitsmaßnahme von VPN-Clients verwendet werden, um das Split Tunneling einzuschränken, wenn das Split Tunneling vom VPN-Client nicht erforderlich ist. Ein VPN-Client kann die SetIpInterfaceEntry-Funktion aufrufen, um den DisableDefaultRoutes-Member bei Bedarf auf TRUE festzulegen. Ein VPN-Client kann den aktuellen Zustand des DisableDefaultRoutes-Members abfragen, indem er die GetIpInterfaceEntry-Funktion aufruft .

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