Funktionen GetIpInterfaceEntry

2025-03-13

Funktionen GetIpInterfaceEntry hämtar IP-information för det angivna gränssnittet på en lokal dator.

Syntax

NETIOAPI_API GetIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parametrar

Rad [in, ut]
En pekare till en MIB_IPINTERFACE_ROW struktur som vid lyckad retur tar emot information för ett gränssnitt på den lokala datorn. Vid indata måste drivrutinen ange InterfaceLuid- medlem eller InterfaceIndex medlem i MIB_IPINTERFACE_ROW till gränssnittet för att hämta information för.

Returvärde

GetIpInterfaceEntry returnerar STATUS_SUCCESS om funktionen lyckas.

Om funktionen misslyckas returnerar GetIpInterfaceEntry någon av följande felkoder:

Returnera kod	Beskrivning
STATUS_INVALID_PARAMETER	En ogiltig parameter skickades till funktionen. Det här felet returneras om en NULL- pekare skickas i parametern Rad. Family medlem i MIB_IPINTERFACE_ROW struktur som Rad parametern pekar på inte har angetts som AF_INET eller AF_INET6, eller InterfaceLuid och InterfaceIndex medlemmar i MIB_IPINTERFACE_ROW struktur var ospecificerade.
STATUS_NOT_FOUND	Det gick inte att hitta det angivna gränssnittet. Det här felet returneras om funktionen inte kan hitta nätverksgränssnittet som anges av InterfaceLuid eller InterfaceIndex medlem i den MIB_IPINTERFACE_ROW struktur som Rad parametern pekar på.
Andra	Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet.

Anmärkningar

Vid indata måste drivrutinen initiera följande medlemmar i den MIB_IPINTERFACE_ROW struktur som rad parametern pekar på.

Familj
Ange till antingen AF_INET eller AF_INET6.
InterfaceLuid eller InterfaceIndex
Dessa medlemmar används i den ordning som anges tidigare. Så om InterfaceLuid anges används den här medlemmen för att fastställa gränssnittet. Om inget värde har angetts för InterfaceLuid medlem (värdet för den här medlemmen har angetts till noll) används InterfaceIndex medlem för att fastställa gränssnittet.

Vid utdata fyller GetIpInterfaceEntry i de återstående medlemmarna i den MIB_IPINTERFACE_ROW struktur som parametern Row pekar på.

Drivrutinen måste använda funktionen InitializeIpInterfaceEntry för att initiera fälten i en MIB_IPINTERFACE_ROW strukturpost med standardvärden. En drivrutin kan sedan ändra fälten i posten MIB_IPINTERFACE_ROW som den vill ändra och sedan anropa funktionen SetIpInterfaceEntry.

Oprivilegierad samtidig åtkomst till flera nätverk med olika säkerhetskrav skapar ett säkerhetshål och gör det möjligt för en oprivilegierad drivrutin att av misstag vidarebefordra data mellan de två nätverken. Ett vanligt exempel är samtidig åtkomst till ett virtuellt privat nätverk (VPN) och Internet. Operativsystemen Windows Server 2003 och Windows XP använder en svag värdmodell, där RAS (Remote Access Service) förhindrar sådan samtidig åtkomst genom att öka vägmåttet för alla standardvägar över andra gränssnitt. Därför dirigeras all trafik via VPN-gränssnittet, vilket stör andra nätverksanslutningar.

I Windows Vista och senare versioner av Windows-operativsystem används som standard en stark värdmodell. Om en käll-IP-adress anges i routningssökningen med hjälp av funktionen GetBestRoute2 begränsas routningssökningen till gränssnittet för källans IP-adress. Modifieringen av routningsmåttet av RAS har ingen effekt eftersom listan över potentiella vägar inte ens har vägen för VPN-gränssnittet, vilket möjliggör trafik till Internet. Drivrutinen kan använda DisableDefaultRoutes medlem i MIB_IPINTERFACE_ROW för att inaktivera med standardvägen i ett gränssnitt. VPN-klienter kan använda den här medlemmen som en säkerhetsåtgärd för att begränsa delade tunnlar när delade tunnlar inte krävs av VPN-klienten. En VPN-klient kan anropa funktionen SetIpInterfaceEntry för att ange DisableDefaultRoutes medlem till TRUE- när det krävs. En VPN-klient kan fråga det aktuella tillståndet för DisableDefaultRoutes medlem genom att anropa funktionen GetIpInterfaceEntry.

Krav

Målplattform	Universell
Version	Finns i Windows Vista och senare versioner av Windows-operativsystemen.
Rubrik	Netioapi.h (inkludera Netioapi.h)
Bibliotek	Netio.lib
IRQL	< DISPATCH_LEVEL