GetTcp6Table2-Funktion (iphlpapi.h)

Artikel
08/24/2023

Die GetTcp6Table2-Funktion ruft die TCP-Verbindungstabelle für IPv6 ab.

Syntax

IPHLPAPI_DLL_LINKAGE ULONG GetTcp6Table2(
  [out]     PMIB_TCP6TABLE2 TcpTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Parameter

[out] TcpTable

Ein Zeiger auf einen Puffer, der die TCP-Verbindungstabelle für IPv6 als MIB_TCP6TABLE2-Struktur empfängt.

[in, out] SizePointer

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

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

[in] Order

Ein Wert, der angibt, ob die TCP-Verbindungstabelle sortiert werden soll. Wenn dieser Parameter TRUE ist, wird die Tabelle in aufsteigender Reihenfolge sortiert, beginnend mit der niedrigsten lokalen IP-Adresse. Wenn dieser Parameter FALSE ist, wird die Tabelle in der Reihenfolge angezeigt, in der sie abgerufen wurden.

Beim Sortieren der TCP-Endpunkte werden die folgenden Werte verglichen (wie aufgeführt):

Lokale IPv6-Adresse
Lokale Bereichs-ID
Lokaler Port
Remote-IPv6-Adresse
Remotebereichs-ID
Remoteport

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 TcpTable-Parameter verweist, ist nicht groß genug. Die erforderliche Größe wird in der Variablen zurückgegeben, auf die der SizePointer-Parameter verweist.
ERROR_INVALID_PARAMETER	Der SizePointer-Parameter ist NULL, oder GetTcp6Table2 kann nicht in den Arbeitsspeicher 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 Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

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

Die GetTcp6Table2-Funktion ist eine erweiterte Version der GetTcp6Table-Funktion , die auch Informationen zum TCP-Auslagerungszustand der TCP-Verbindung abruft.

Anforderungen


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