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 |