GetIpNetTable-Funktion (iphlpapi.h)

Artikel
03/13/2024

Die GetIpNetTable-Funktion ruft die IPv4-Tabelle für die Zuordnung physischer Adressen ab.

Syntax

IPHLPAPI_DLL_LINKAGE ULONG GetIpNetTable(
  [out]     PMIB_IPNETTABLE IpNetTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Parameter

[out] IpNetTable

Ein Zeiger auf einen Puffer, der die IPv4-Tabelle zur physischen Adresszuordnung als MIB_IPNETTABLE Struktur empfängt.

[in, out] SizePointer

Gibt bei der Eingabe die Größe des Puffers in Bytes an, auf den der pIpNetTable-Parameter verweist.

Wenn der Puffer bei der Ausgabe nicht groß genug ist, um die zurückgegebene Zuordnungstabelle aufzunehmen, legt die Funktion diesen Parameter auf die erforderliche Puffergröße in Bytes fest.

[in] Order

Ein boolescher Wert, der angibt, ob die zurückgegebene Zuordnungstabelle in aufsteigender Reihenfolge nach IP-Adresse sortiert werden soll. Wenn dieser Parameter TRUE ist, wird die Tabelle sortiert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR oder ERROR_NO_DATA.

Wenn die Funktion fehlschlägt oder keine Daten zurückgibt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INSUFFICIENT_BUFFER	Der Puffer, auf den der pIpNetTable-Parameter verweist, ist nicht groß genug. Die erforderliche Größe wird in der DWORD-Variablen zurückgegeben, auf die der pdwSize-Parameter verweist.
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn der pdwSize-ParameterNULL ist oder GetIpNetTable nicht in den Arbeitsspeicher schreiben kann, auf den der pdwSize-Parameter verweist.
ERROR_NO_DATA	Es sind keine Daten zurückzugeben. Die Tabelle für die Zuordnung von IPv4 zu physischen Adressen ist leer. Dieser Rückgabewert gibt an, dass der Aufruf der GetIpNetTable-Funktion erfolgreich war, aber keine Daten zurückgegeben wurden.
ERROR_NOT_SUPPORTED	Der IPv4-Transport ist auf dem lokalen Computer nicht konfiguriert.
Andere	Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

The
Die GetIpNetTable-Funktion listet die ARP-Einträge (Address Resolution Protocol) für IPv4 auf einem lokalen System aus der IPv4-Tabelle zur physischen Adresszuordnung auf und gibt diese Informationen in einer MIB_IPNETTABLE-Struktur zurück.

Die IPv4-Adresseinträge werden in einer MIB_IPNETTABLE-Struktur im Puffer zurückgegeben, auf den der pIpNetTable-Parameter verweist. Die MIB_IPNETTABLE-Struktur enthält eine Anzahl von ARP-Einträgen und ein Array von MIB_IPNETROW Strukturen für jeden IPv4-Adresseintrag.

Beachten Sie, dass die zurückgegebene MIB_IPNETTABLE-Struktur , auf die vom pIpNetTable-Parameter verwiesen wird, eine Auffüllung für die Ausrichtung zwischen dem dwNumEntries-Element und dem ersten MIB_IPNETROW Arrayeintrag im Tabellenmember der MIB_IPNETTABLE-Struktur enthalten kann. Zwischen den MIB_IPNETROW Arrayeinträgen kann auch ein Abstand für die Ausrichtung vorhanden sein. Bei jedem Zugriff auf einen MIB_IPNETROW Arrayeintrag sollte davon ausgegangen werden, dass eine Auffüllung vorhanden ist.

Unter Windows Vista und höher kann die GetIpNetTable2-Funktion verwendet werden, um die benachbarten IP-Adressen sowohl für IPv6 als auch für IPv4 abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll