GetIfEntry2Ex-Funktion (netioapi.h)

Artikel
03/04/2024

Die GetIfEntry2Ex-Funktion ruft die angegebene Informationsebene für die angegebene Schnittstelle auf dem lokalen Computer ab.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfEntry2Ex(
  [in]      MIB_IF_ENTRY_LEVEL Level,
  [in, out] PMIB_IF_ROW2       Row
);

Parameter

[in] Level

Die Ebene der abzurufenden Schnittstelleninformationen. Dieser Parameter kann einer der Werte aus dem MIB_IF_ENTRY_LEVEL Enumerationstyp sein, der in der Headerdatei Netioapi.h definiert ist.

Wert	Bedeutung
MibIfEntryNormal 0	Die Werte der Statistiken und des Zustands, die in Membern der MIB_IF_ROW2 Struktur zurückgegeben werden, auf die der Row-Parameter verweist, werden vom oberen Rand des Filterstapels zurückgegeben.
MibIfEntryNormalWithoutStatistics 2	Die Werte des Zustands (ohne Statistiken), die in Membern der MIB_IF_ROW2 Struktur zurückgegeben werden, auf die der Row-Parameter verweist, werden vom Anfang des Filterstapels zurückgegeben.

[in, out] Row

Ein Zeiger auf eine MIB_IF_ROW2 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-Member des MIB_IF_ROW2 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_IF_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-Parameter im Row-Parameter übergeben wird. Dieser Fehler wird auch zurückgegeben, wenn sowohl das InterfaceLuid - als auch das InterfaceIndex-Element des MIB_IF_ROW2 vom Row-Parameter nicht angegeben sind.
Andere	Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

The
Die GetIfEntry2Ex-Funktion ruft Informationen für eine angegebene Schnittstelle auf einem lokalen System ab und gibt diese Informationen in einem Zeiger auf ein zurück.
MIB_IF_ROW2 Struktur. GetIfEntry2Ex ist eine erweiterte Version der GetIfEntry2-Funktion , mit der die Ebene der abzurufenden Schnittstelleninformationen ausgewählt werden kann.

Bei der Eingabe muss mindestens eines der folgenden Member in der MIB_IF_ROW2-Struktur initialisiert werden, die im Row-Parameter übergeben wird: 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 (der Wert dieses Members wurde auf Null festgelegt), wird das InterfaceIndex-Element als nächstes verwendet, um die Schnittstelle zu bestimmen.

Bei der Ausgabe werden die verbleibenden Felder der MIB_IF_ROW2 Struktur ausgefüllt, auf die der Row-Parameter verweist.

Beachten Sie, dass die Netioapi.h-Headerdatei automatisch in der Headerdatei Iphlpapi.h enthalten ist und niemals direkt verwendet werden sollte.

Anforderungen

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