Freigeben über


GetIpNetEntry2-Funktion

Die GetIpNetEntry2--Funktion ruft Informationen für einen Ip-Adresseintrag des Nachbarn auf dem lokalen Computer ab.

Syntax

NETIOAPI_API GetIpNetEntry2(
  _Inout_ PMIB_IPNET_ROW2 Row
);

Parameter

  • Zeile [in, out]
    Ein Zeiger auf einen MIB_IPNET_ROW2 Struktureintrag für einen Ip-Adresseintrag des Nachbarn. Bei erfolgreicher Rückgabe wird diese Struktur mit den Eigenschaften für die BENACHBARTE IP-Adresse aktualisiert.

Rückgabewert

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

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

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER

An die Funktion wurde ein ungültiger Parameter übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL- Zeiger im parameter Row übergeben wird, das Address Member der MIB_IPNET_ROW2-Struktur, auf das der parameter Row verweist, nicht auf eine gültige IPv4- oder IPv6-Adresse festgelegt wurde, oder InterfaceLuid und InterfaceIndex Member der MIB_IPNET_ROW2 Struktur wurden nicht angegeben.

STATUS_NOT_FOUND

Die angegebene Schnittstelle konnte nicht gefunden werden. Dieser Fehler wird zurückgegeben, wenn die Funktion die Netzwerkschnittstelle nicht finden kann, die durch die InterfaceLuid oder InterfaceIndex Member der MIB_IPNET_ROW2 Struktur angegeben wird, auf die der Row Parameter verweist.

STATUS_NOT_SUPPORTED

Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich kein IPv4-Stapel auf dem lokalen Computer befindet und eine IPv4-Adresse im Address Member der MIB_IPNET_ROW2-Struktur angegeben wurde, auf die der Row Parameter verweist, oder wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet und eine IPv6-Adresse im Address Member angegeben wurde.

Andere

Verwenden Sie die FormatMessage--Funktion, um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Bemerkungen

Die GetIpNetEntry2--Funktion wird verwendet, um einen MIB_IPNET_ROW2 Struktureintrag abzurufen.

Bei der Eingabe muss der Treiber die folgenden Elemente der MIB_IPNET_ROW2 Struktur initialisieren, auf die der parameter Row verweist.

  • Adresse
    Auf eine gültige IPv4- oder IPv6-Adresse und Familie des Nachbarn festgelegt.

  • InterfaceLuid oder InterfaceIndex-
    Diese Member werden in der Reihenfolge verwendet, die zuvor aufgeführt ist. Wenn also InterfaceLuid- angegeben wird, wird dieses Element verwendet, um die Schnittstelle zu bestimmen. Wenn kein Wert für das InterfaceLuid Member festgelegt wurde (der Wert dieses Elements wurde auf Null festgelegt), wird das InterfaceIndex Member als Nächstes verwendet, um die Schnittstelle zu bestimmen.

Wenn der Aufruf erfolgreich ist, ruft GetIpNetEntry2 die anderen Eigenschaften für die benachbarte IP-Adresse ab und füllt die MIB_IPNET_ROW2 Struktur aus, auf die der Row Parameter verweist.

Ihr Treiber kann die GetIpNetTable2--Funktion aufrufen, um die Einträge der benachbarten IP-Adressen auf einem lokalen Computer auflisten zu können.

Anforderungen

Zielplattform

universelle

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Kopfball

Netioapi.h (include Netioapi.h)

Bibliothek

Netio.lib

IRQL

< DISPATCH_LEVEL

Siehe auch

GetIpNetTable2-

MIB_IPNET_ROW2