MIB_TCP6ROW2 结构 (tcpmib.h)

项目
08/26/2023

MIB_TCP6ROW2结构包含描述 IPv6 TCP 连接的信息。

语法

typedef struct _MIB_TCP6ROW2 {
  IN6_ADDR                     LocalAddr;
  DWORD                        dwLocalScopeId;
  DWORD                        dwLocalPort;
  IN6_ADDR                     RemoteAddr;
  DWORD                        dwRemoteScopeId;
  DWORD                        dwRemotePort;
  MIB_TCP_STATE                State;
  DWORD                        dwOwningPid;
  TCP_CONNECTION_OFFLOAD_STATE dwOffloadState;
} MIB_TCP6ROW2, *PMIB_TCP6ROW2;

成员

LocalAddr

类型： IN6_ADDR

本地计算机上的 TCP 连接的本地 IPv6 地址。值为零表示侦听器可以接受任何接口上的连接。

dwLocalScopeId

类型：DWORD

本地计算机上的 TCP 连接的本地范围 ID。

dwLocalPort

类型：DWORD

本地计算机上的 TCP 连接的本地端口号（按网络字节顺序）。

IP 端口号的最大大小为 16 位，因此只应使用较低的 16 位。上限 16 位可能包含未初始化的数据。

RemoteAddr

类型： IN6_ADDR

远程计算机上的 TCP 连接的 IPv6 地址。当状态成员 MIB_TCP_STATE_LISTEN时，此值没有任何意义。

dwRemoteScopeId

类型：DWORD

远程计算机上的 TCP 连接的远程范围 ID。当状态成员 MIB_TCP_STATE_LISTEN时，此值没有任何意义。

dwRemotePort

类型：DWORD

远程计算机上的 TCP 连接的远程端口号（按网络字节顺序）。当状态成员 MIB_TCP_STATE_LISTEN时，此值没有任何意义。

IP 端口号的最大大小为 16 位，因此只应使用较低的 16 位。上限 16 位可能包含未初始化的数据。

State

类型： MIB_TCP_STATE

TCP 连接的状态。此成员可以是 Tcpmib.h 头文件中定义的 MIB_TCP_STATE 枚举类型的值之一。

值	含义
MIB_TCP_STATE_CLOSED 1	TCP 连接处于“已关闭”状态，表示完全没有连接状态。
MIB_TCP_STATE_LISTEN 2	TCP 连接处于 LISTEN 状态，等待来自任何远程 TCP 和端口的连接请求。
MIB_TCP_STATE_SYN_SENT 3	在发送连接请求后，TCP 连接处于 SYN-SENT 状态，等待匹配的连接请求 (SYN 数据包) 。
MIB_TCP_STATE_SYN_RCVD 4	在收到并发送连接请求后，TCP 连接处于 SYN-RECEIVED 状态，等待确认连接请求确认 (SYN 数据包) 。
MIB_TCP_STATE_ESTAB 5	TCP 连接处于“已建立”状态，表示打开的连接，接收的数据可以传递给用户。这是 TCP 连接的数据传输阶段的正常状态。
MIB_TCP_STATE_FIN_WAIT1 6	TCP 连接为 FIN-WAIT-1 状态，等待来自远程 TCP 的连接终止请求，或确认之前发送的连接终止请求。
MIB_TCP_STATE_FIN_WAIT2 7	TCP 连接为 FIN-WAIT-1 状态，等待来自远程 TCP 的连接终止请求。
MIB_TCP_STATE_CLOSE_WAIT 8	TCP 连接处于 CLOSE-WAIT 状态，等待来自本地用户的连接终止请求。
MIB_TCP_STATE_CLOSING 9	TCP 连接处于正在关闭状态，等待来自远程 TCP 的连接终止请求确认。
MIB_TCP_STATE_LAST_ACK 10	TCP 连接处于 LAST-ACK 状态，等待确认之前发送到远程 TCP (包括确认其连接终止请求) 。
MIB_TCP_STATE_TIME_WAIT 11	TCP 连接处于 TIME-WAIT 状态，等待足够的时间通过，以确保远程 TCP 收到对其连接终止请求的确认。
MIB_TCP_STATE_DELETE_TCB 12	TCP 连接处于删除 TCB 状态，表示删除传输控制块 (TCB) ，该数据结构用于维护每个 TCP 条目的信息。

dwOwningPid

类型：DWORD

为此 TCP 连接发出上下文绑定的进程 PID。

dwOffloadState

类型： TCP_CONNECTION_OFFLOAD_STATE

此 TCP 连接的卸载状态。此参数可以是 Tcpmib.h 标头中定义的TCP_CONNECTION_OFFLOAD_STATE的枚举值之一。

注解

MIB_TCP6ROW2结构在 Windows Vista 及更高版本上定义。

GetTcp6Table2 函数检索本地计算机上的 IPv6 TCP 连接表，并在MIB_TCP6TABLE2结构中返回此信息。

MIB_TCP6TABLE2 结构中包含MIB_TCP6ROW2结构的数组。

状态成员指示 TCP 状态图中 TCP 条目的状态。 TCP 连接在其生存期内通过一系列状态进行。状态为：LISTEN、SYN-SENT、SYN-RECEIVED、已建立、FIN-WAIT-1、FIN-WAIT-2、CLOSE-WAIT、CLOSE-WAIT、CLOSE-ACK、TIME-WAIT 和虚构状态 CLOSED。关闭状态是虚构的，因为它表示没有传输控制块时的状态，因此没有连接。 RFC 793 中介绍了 TCP 协议。有关详细信息，请参阅 http://www.ietf.org/rfc/rfc793.txt。

dwLocalPort 和 dwRemotePort 成员按网络字节顺序排列。若要使用 dwLocalPort 或 dwRemotePort 成员，可能需要 Windows 套接字中的 ntohs 或 inet_ntoa 函数或类似函数。

dwLocalScopeId 和 dwRemoteScopeId 成员按网络字节顺序排列。若要使用 dwLocalScopeId 或 dwRemoteScopeId 成员，可能需要 Windows 套接字中的 ntohl 或 inet_ntoa 函数或类似函数。

LocalAddr 和 RemoteAddr 成员存储在in6_addr结构中。 RtlIpv6AddressToString 或 RtlIpv6AddressToStringEx 函数可用于在不加载 Windows 套接字 DLL 的情况下将 LocalAddr 或 RemoteAddr 成员中的 IPv6 地址转换为字符串。

要求


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	tcpmib.h (包括 Iphlpapi.h)