GetIfEntry2-Funktion
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 |