Partager via

GetTcp6Table2 (Compact 7)

  • Article

3/12/2014

This function retrieves the TCP connection table for IPv6.

Syntax

ULONG WINAPI GetTcp6Table2(
  __out    PMIB_TCP6TABLE2 TcpTable,
  __inout  PULONG SizePointer,
  __in     BOOL Order
);

Parameters

  • TcpTable
    A pointer to a buffer that receives the TCP connection table for IPv6 as a MIB_TCP6TABLE2 structure.

  • SizePointer
    On input, specifies the size of the buffer pointed to by the TcpTable parameter.

    On output, if the buffer is not large enough to hold the returned TCP connection table, the function sets this parameter equal to the required buffer size.

  • Order
    A value that specifies whether the TCP connection table should be sorted. If this parameter is TRUE, the table is sorted in ascending order, starting with the lowest local IP address. If this parameter is FALSE, the table appears in the order in which they were retrieved.

    The following values are compared (as listed) when ordering the TCP endpoints:

    1. Local IPv6 address
    2. Local scope ID
    3. Local port
    4. Remote IPv6 address
    5. Remote scope ID
    6. Remote port

Return Value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Return code Description

ERROR_INSUFFICIENT_BUFFER

The buffer pointed to by the TcpTable parameter is not large enough. The required size is returned in the variable pointed to by the SizePointer parameter.

ERROR_INVALID_PARAMETER

The SizePointer parameter is NULL, or GetTcp6Table2 is unable to write to the memory pointed to by the SizePointer parameter.

ERROR_NOT_SUPPORTED

This function is not supported on the operating system as it is being used on the local system.

Other

Use FormatMessage to obtain the message string for the returned error.

Remarks

The GetTcp6Table2 function is an enhanced version of the GetTcp6Table function that also retrieves information on the TCP offload state of the TCP connection

See Also

Reference

IP Helper Functions
GetExtendedTcpTable
GetOwnerModuleFromTcp6Entry
GetTcpStatisticsEx
GetTcp6Table
GetTcpTable
MIB_TCP6ROW
MIB_TCP6ROW_OWNER_MODULE
MIB_TCP6ROW_OWNER_PID
MIB_TCP6ROW2
MIB_TCP6TABLE
MIB_TCP6TABLE_OWNER_MODULE
MIB_TCP6TABLE_OWNER_PID
MIB_TCP6TABLE2