Freigeben über


GetIpNetTable2-Funktion

Die GetIpNetTable2--Funktion ruft die IP-Nachbartabelle auf einem lokalen Computer ab.

Syntax

NETIOAPI_API GetIpNetTable2(
  _In_  ADDRESS_FAMILY    Family,
  _Out_ PMIB_IPNET_TABLE2 *Table
);

Parameter

  • Family [in]
    Die abzurufende Adressfamilie.

    Mögliche Werte für die Adressfamilie sind in der Winsock2.h-Headerdatei aufgeführt. Beachten Sie, dass die Werte für die AF_ Adressfamilie und PF_ Protokollfamilienkonstanten identisch sind (z. B. AF_INET und PF_INET), sodass Sie eine der beiden Konstanten verwenden können.

    Unter Windows Vista und höheren Versionen der Windows-Betriebssysteme werden mögliche Werte für den Parameter Family in der Headerdatei Ws2def.h definiert. Beachten Sie, dass die Headerdatei Ws2def.h automatisch in Netioapi.h enthalten ist und Sie Ws2def.h niemals direkt verwenden sollten.

    Die folgenden Werte werden derzeit für die Adressfamilie unterstützt:

    • AF_INET
      Die IPv4-Adressfamilie. Wenn dieser Wert angegeben wird, gibt diese Funktion die Benachbarte IP-Adresstabelle zurück, die nur IPv4-Einträge enthält.

    • AF_INET6
      Die IPv6-Adressfamilie. Wenn dieser Wert angegeben wird, gibt diese Funktion die Benachbarte IP-Adresstabelle zurück, die nur IPv6-Einträge enthält.

    • AF_UNSPEC
      Die Adressfamilie ist nicht angegeben. Wenn dieser Wert angegeben wird, gibt diese Funktion die Benachbarte IP-Adresstabelle zurück, die sowohl IPv4- als auch IPv6-Einträge enthält.

  • Tabelle [out]
    Ein Zeiger auf eine MIB_IPNET_TABLE2-Struktur, die eine Tabelle benachbarter IP-Adresseinträge auf dem lokalen Computer enthält.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt GetIpNetTable2- 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 Table Parameter übergeben wird oder der parameter Family nicht als AF_INET, AF_INET6 oder AF_UNSPEC angegeben wurde.

STATUS_NOT_ENOUGH_MEMORY

Unzureichende Arbeitsspeicherressourcen sind verfügbar, um den Vorgang abzuschließen.

STATUS_NOT_FOUND

Es wurden keine Ip-Adresseinträge des Nachbarn gefunden, wie im Parameter Family angegeben.

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 AF_INET im Parameter Family angegeben wurde oder wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet und AF_INET6 im parameter Family angegeben wurde. Dieser Fehler wird auch in Versionen von Windows zurückgegeben, in denen diese Funktion nicht unterstützt wird.

Andere

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

Bemerkungen

Die GetIpNetTable2--Funktion listet die benachbarten IP-Adressen auf einem lokalen Computer auf und gibt diese Informationen in einer MIB_IPNET_TABLE2 Struktur zurück.

GetIpNetTable2- gibt die Benachbarten IP-Adresseinträge in einer MIB_IPNET_TABLE2 Struktur im Puffer zurück, auf die der Table Parameter verweist. Die MIB_IPNET_TABLE2-Struktur enthält eine Anzahl der Ip-Adresseneingaben des Nachbarn und ein Array von MIB_IPNET_ROW2 Strukturen für jeden Ip-Adresseintrag des Nachbarn. Wenn diese zurückgegebenen Strukturen nicht mehr benötigt werden, sollte Der Treiber den Speicher freigeben, indem FreeMibTable-aufgerufen wird.

Der Treiber muss den Parameter Family entweder in AF_INET, AF_INET6 oder AF_UNSPEC initialisieren.

Beachten Sie, dass die zurückgegebene MIB_IPNET_TABLE2 Struktur, auf die der Table Parameter verweist, einen Abstand für die Ausrichtung zwischen dem NumEntries-Element und dem ersten MIB_IPNET_ROW2 Arrayeintrag im Table Member der MIB_IPNET_TABLE2-Struktur enthalten kann. Der Abstand für die Ausrichtung kann auch zwischen den MIB_IPNET_ROW2 Arrayeinträgen vorhanden sein. Jeder Zugriff auf einen MIB_IPNET_ROW2 Arrayeintrag sollte davon ausgehen, dass der Abstand vorhanden ist.

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

CreateIpNetEntry2-

FlushIpNetTable2-

FreeMibTable-

GetIpNetEntry2-

MIB_IPNET_ROW2

MIB_IPNET_TABLE2

ResolveIpNetEntry2-

SetIpNetEntry2-