GetIfEntry2-Funktion

Artikel
04/24/2024

Die GetIfEntry2-Funktion ruft Informationen für die angegebene Schnittstelle auf einem lokalen Computer ab.

Wichtig

Für Treiberentwickler wird empfohlen, GetIfEntry2Ex falls möglich, mit MibIfEntryNormalWithoutStatistics zu verwenden, um bei der Wartung von NDIS-OIDs einen Deadlock zu vermeiden.

Syntax

NETIOAPI_API GetIfEntry2(
  _Inout_ PMIB_IF_ROW2 Row
);

Parameter

Zeile [in, out]
Ein Zeiger auf eine MIB_IF_ROW2-Struktur, die beim erfolgreichen Zurückgeben Informationen für eine Schnittstelle auf dem lokalen Computer empfängt. Bei der Eingabe muss der Treiber das Element InterfaceLuid oder InterfaceIndex der MIB_IF_ROW2-Struktur auf die Schnittstelle festlegen, für die Informationen abgerufen werden sollen.

Rückgabewert

GetIfEntry2 gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.

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

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Ein ungültiger Parameter wurde an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Row-Parameter übergeben wird.
STATUS_NOT_FOUND	Die angegebene Schnittstelle kann nicht gefunden werden. Dieser Fehler wird zurückgegeben, wenn die Funktion die Netzwerkschnittstelle nicht finden kann, die vom Element InterfaceLuid oder InterfaceIndex der MIB_IF_ROW2-Struktur angegeben wird, auf die der ParameterRow zeigt.
Andere	Verwenden Sie die FormatMessage-Funktion, um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Bei der Eingabe muss der Treiber mindestens das Element InterfaceLuid oder InterfaceIndex in der MIB_IF_ROW2-Struktur initialisieren, die im Row-Parameter übergeben wird. Die Elemente werden in der Reihenfolge verwendet, die zuvor aufgeführt ist. Wenn InterfaceLuid angegeben ist, wird dieses Element verwendet, um die Schnittstelle zu bestimmen. Wenn kein Wert für das InterfaceLuid-Element festgelegt wurde (der Wert dieses Elements wurde auf Null gesetzt), wird InterfaceIndex als Nächstes verwendet, um die Schnittstelle zu bestimmen.

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

Anforderungen

Zielplattform	Universell
Version	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header	Netioapi.h (Netioapi.h einschließen)
Bibliothek	Netio.lib
IRQL	< DISPATCH_LEVEL

Weitere Informationen

Freigeben über