GetUdp6Table-Funktion (iphlpapi.h)

Artikel
02/28/2024

Die GetUdp6Table-Funktion ruft die UDP-Listenertabelle (IPv6 User Datagram Protocol) ab.

Syntax

IPHLPAPI_DLL_LINKAGE ULONG GetUdp6Table(
  [out]     PMIB_UDP6TABLE Udp6Table,
  [in, out] PULONG         SizePointer,
  [in]      BOOL           Order
);

Parameter

[out] Udp6Table

Ein Zeiger auf einen Puffer, der die IPv6 UDP-Listenertabelle als MIB_UDP6TABLE-Struktur empfängt.

[in, out] SizePointer

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

Wenn der Puffer bei der Ausgabe nicht groß genug ist, um die zurückgegebene Listenertabelle zu enthalten, legt die Funktion diesen Parameter gleich der erforderlichen Puffergröße in Bytes fest.

[in] Order

Ein boolescher Wert, der angibt, ob die zurückgegebene UDP-Listenertabelle sortiert werden soll. Wenn dieser Parameter TRUE ist, wird die Tabelle in der Reihenfolge sortiert:

Lokale IPv6-Adresse
Id des lokalen Bereichs
Lokaler Port

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INSUFFICIENT_BUFFER	Der Puffer, auf den der Udp6Table-Parameter verweist, ist nicht groß genug. Die erforderliche Größe wird in der ULONG-Variablen zurückgegeben, auf die der SizePointer-Parameter verweist.
ERROR_INVALID_PARAMETER	Der SizePointer-Parameter ist NULL, oder GetUdp6Table kann nicht in den Speicher schreiben, auf den der SizePointer-Parameter verweist.
ERROR_NOT_SUPPORTED	Diese Funktion wird auf dem Betriebssystem, das auf dem lokalen System verwendet wird, nicht unterstützt.
Andere	Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die GetUdp6Table-Funktion ist unter Windows Vista und höher definiert.

Anforderungen

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