Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |