GetIpNetTable-Funktion (iphlpapi.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
Der IPv4-Transport ist auf dem lokalen Computer nicht konfiguriert. |
|
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 |