Freigeben über


GetUnicastIpAddressTable-Funktion

Die GetUnicastIpAddressTable-Funktion ruft die Unicast-IP-Adresstabelle auf einem lokalen Computer ab.

Syntax

NETIOAPI_API GetUnicastIpAddressTable(
  _In_  ADDRESS_FAMILY              Family,
  _Out_ PMIB_UNICASTIPADDRESS_TABLE *Table
);

Parameter

  • Familie [in]
    Die abzurufende Adressfamilie.

    Mögliche Werte für die Adressfamilie sind in der Headerdatei Winsock2.h 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 beide Konstanten verwenden können.

    Unter Windows Vista und höheren Versionen der Windows-Betriebssysteme werden mögliche Werte für den Family-Parameter in der Ws2def.h-Headerdatei definiert. Beachten Sie, dass die Ws2def.h-Headerdatei 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 Multicast-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 Multicast-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 Multicast-IP-Adresstabelle zurück, die sowohl IPv4- als auch IPv6-Einträge enthält.

  • Tabelle [out]
    Ein Zeiger auf eine MIB_UNICASTIPADDRESS_TABLE-Struktur , die eine Tabelle mit Unicast-IP-Adresseinträgen auf dem lokalen Computer enthält.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt GetUnicastIpAddressTable einen der folgenden Fehlercodes zurück:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER

Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Table-Parameter übergeben oder der Family-Parameter nicht als AF_INET, AF_INET6 oder AF_UNSPEC angegeben wurde.

STATUS_NOT_ENOUGH_MEMORY

Für den Vorgang stehen nicht genügend Arbeitsspeicherressourcen zur Verfügung.

STATUS_NOT_FOUND

Es wurden keine Unicast-IP-Adresseinträge gefunden, wie im Family-Parameter 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 Family-Parameter angegeben wurde, oder wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet und AF_INET6 im Family-Parameter angegeben wurde. Dieser Fehler wird auch bei 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 GetUnicastIpAddressTable-Funktion listet die Unicast-IP-Adressen auf einem lokalen Computer auf und gibt diese Informationen in einer MIB_UNICASTIPADDRESS_TABLE-Struktur zurück.

GetUnicastIpAddressTable gibt die Unicast-IP-Adresseinträge in einer MIB_UNICASTIPADDRESS_TABLE-Struktur im Puffer zurück, auf den der Table-Parameter verweist. Die MIB_UNICASTIPADDRESS_TABLE-Struktur enthält eine Unicast-IP-Adresseintragsanzahl und ein Array von MIB_UNICASTIPADDRESS_ROW Strukturen für jeden Unicast-IP-Adresseintrag. Wenn diese zurückgegebenen Strukturen nicht mehr erforderlich sind, sollte Ihr Treiber den Speicher durch Aufrufen von FreeMibTable freigeben.

Ihr Treiber muss den Family-Parameter initialisieren, um entweder AF_INET, AF_INET6 oder AF_UNSPEC.

Beachten Sie, dass die zurückgegebene MIB_UNICASTIPADDRESS_TABLE Struktur, auf die der Table-Parameter verweist, möglicherweise eine Füllung für die Ausrichtung zwischen dem NumEntries-Member und dem ersten MIB_UNICASTIPADDRESS_ROW Arrayeintrag im Table-Member der MIB_UNICASTIPADDRESS_TABLE-Struktur enthalten kann. Zwischen den MIB_UNICASTIPADDRESS_ROW Arrayeinträgen kann auch ein Abstand für die Ausrichtung vorhanden sein. Bei jedem Zugriff auf einen MIB_UNICASTIPADDRESS_ROW Arrayeintrag sollte davon ausgegangen werden, dass eine Auffüllung vorhanden ist.

Anforderungen

Zielplattform

Universell

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Header

Netioapi.h (einschließlich Netioapi.h)

Bibliothek

Netio.lib

IRQL

< DISPATCH_LEVEL

Weitere Informationen

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

FreeMibTable

GetUnicastIpAddressEntry

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyStableUnicastIpAddressTable

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry