MIB_TCP6ROW_OWNER_MODULE 结构 (tcpmib.h)

项目
08/26/2023

MIB_TCP6ROW_OWNER_MODULE结构包含的信息描述绑定到具有所有权数据的特定进程 ID (PID) 的 IPv6 TCP 连接。

语法

typedef struct _MIB_TCP6ROW_OWNER_MODULE {
  UCHAR         ucLocalAddr[16];
  DWORD         dwLocalScopeId;
  DWORD         dwLocalPort;
  UCHAR         ucRemoteAddr[16];
  DWORD         dwRemoteScopeId;
  DWORD         dwRemotePort;
  DWORD         dwState;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_TCP6ROW_OWNER_MODULE, *PMIB_TCP6ROW_OWNER_MODULE;

成员

ucLocalAddr[16]

类型： UCHAR[16]

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

dwLocalScopeId

类型：DWORD

本地 IPv6 地址的网络字节顺序范围 ID。

dwLocalPort

类型：DWORD

本地计算机上 TCP 连接的本地终结点的端口号（以网络字节顺序表示）。

ucRemoteAddr[16]

类型： UCHAR[16]

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

dwRemoteScopeId

类型：DWORD

远程 IPv6 地址的网络字节顺序范围 ID。

dwRemotePort

类型：DWORD

远程计算机上 TCP 连接的远程终结点的网络字节顺序端口号。

dwState

类型：DWORD

TCP 连接的状态。此成员可以是 Tcpmib.h 头文件中定义的 MIB_TCP_STATE 枚举中的值之一。请注意，Tcpmib.h 头文件会自动包含在 Iphlpapi.h 头文件中，Iprtrmib.h 中会自动包含该文件。不应直接使用 Tcpmib.h 和 Iprtrmib.h 头文件。

值	含义
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。

liCreateTimestamp

类型： LARGE_INTEGER

FILETIME 结构，指示创建此 TCP 连接的上下文绑定操作何时发生。

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

类型： ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

包含所有权信息的不透明数据数组。

注解

MIB_TCP6TABLE_OWNER_MODULE结构通过调用 GetExtendedTcpTable 返回，其中 TableClass 参数设置为 TCP_TABLE_OWNER_MODULE_LISTENER、TCP_TABLE_OWNER_MODULE_CONNECTIONS或TCP_TABLE_OWNER_MODULE_ALL，TCP_TABLE_CLASS 枚举将 ulAf 参数设置为 AF_INET6。 MIB_TCP6TABLE_OWNER_MODULE 结构包含MIB_TCP6ROW_OWNER_MODULE结构的数组。

dwState 成员指示 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。

ucLocalAddr 和 ucRemoteAddr 成员以网络字节顺序存储在字符数组中。 RtlIpv6AddressToString 或 RtlIpv6AddressToStringEx 函数可用于将 ucLocalAddr 或 ucRemoteAddr 成员中的 IPv6 地址转换为字符串，而无需加载 Windows 套接字 DLL。

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

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

在 Windows Vista 及更高版本发布的 Microsoft Windows 软件开发工具包 (Windows SDK) (SDK) 中，头文件的组织已更改。此结构在 Tcpmib.h 头文件中定义，而不是 在 Iprtrmib.h 头文件中定义。请注意，Tcpmib.h 头文件会自动包含在 Iphlpapi.h 头文件中，Iprtrmib.h 中会自动包含该文件。不应直接使用 Tcpmib.h 和 Iprtrmib.h 头文件。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008、Windows Server 2003 SP1 [仅限桌面应用]
标头	tcpmib.h (包括 Iphlpapi.h)