Freigeben über


GetTcp6Table2-Funktion (iphlpapi.h)

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):

  1. Lokale IPv6-Adresse
  2. Lokale Bereichs-ID
  3. Lokaler Port
  4. Remote-IPv6-Adresse
  5. Remotebereichs-ID
  6. 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

Weitere Informationen

GetExtendedTcpTable

GetOwnerModuleFromTcp6Entry

GetTcp6Table

GetTcpStatisticsEx

GetTcpTable

MIB_TCP6ROW

MIB_TCP6ROW2

MIB_TCP6ROW_OWNER_MODULE

MIB_TCP6ROW_OWNER_PID

MIB_TCP6TABLE

MIB_TCP6TABLE2

MIB_TCP6TABLE_OWNER_MODULE

MIB_TCP6TABLE_OWNER_PID