udpmib.h) (MIB_UDP6ROW_OWNER_MODULE 结构

项目
03/03/2024

MIB_UDP6ROW_OWNER_MODULE 结构包含本地计算机上 IPv6 的 UDP) 侦听器表 (用户数据报协议中的条目。此条目还包括任何可用的所有权数据和进程 ID (PID) ，该数据向 UDP 终结点的绑定函数发出调用。

语法

typedef struct _MIB_UDP6ROW_OWNER_MODULE {
  UCHAR         ucLocalAddr[16];
  DWORD         dwLocalScopeId;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDP6ROW_OWNER_MODULE, *PMIB_UDP6ROW_OWNER_MODULE;

成员

ucLocalAddr[16]

类型： UCHAR[16]

本地计算机上 UDP 终结点的 IPv6 地址。此成员按网络字节顺序存储在字符数组中。

值为零表示 UDP 侦听器愿意接受与本地计算机关联的任何 IP 接口的数据报。

dwLocalScopeId

类型：DWORD

本地计算机上 UDP 终结点的 IPv6 地址的范围 ID。

dwLocalPort

类型：DWORD

本地 UDP 终结点的端口号。

dwOwningPid

类型：DWORD

为此终结点发出上下文绑定的进程 PID。如果此值设置为 0，则此终结点的信息不可用。

liCreateTimestamp

类型： LARGE_INTEGER

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

SpecificPortBind

类型： int

一个值，该值指示是否在上一个上下文绑定操作中指定了特定端口。

dwFlags

类型： int

一组标志。当前未使用此成员。

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

类型： ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

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

注解

MIB_UDP6TABLE_OWNER_MODULE 结构通过调用 GetExtendedUdpTable 返回，其中 TableClass 参数设置为 UDP_TABLE_CLASS 枚举中的UDP_TABLE_OWNER_MODULE，ulAf 参数设置为 AF_INET6。 MIB_UDP6TABLE_OWNER_MODULE 结构包含MIB_UDP6ROW_OWNER_MODULE结构的数组。

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

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

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

MIB_UDP6TABLE_OWNER_MODULE结构包含本地计算机上 IPv6 的 UDP 侦听器表。该名称基于 IETF 发布的 RFC 2454 中此表的定义。有关详细信息，请参阅 http://www.ietf.org/rfc/rfc2454.txt。此表包含已绑定到地址的 IPv6 UDP 终结点。应注意的是，应用程序可以创建 UDP 套接字并将其绑定到地址，其唯一目的是发送 UDP 数据报，而无意使用此套接字接收数据包 (充当侦听器) 。

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

要求

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