MIB_UDPROW_OWNER_MODULE结构 (udpmib.h)

项目
03/13/2024

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

语法

typedef struct _MIB_UDPROW_OWNER_MODULE {
  DWORD         dwLocalAddr;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDPROW_OWNER_MODULE, *PMIB_UDPROW_OWNER_MODULE;

成员

dwLocalAddr

类型：DWORD

本地计算机上的 UDP 终结点的 IPv4 地址。

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

dwLocalPort

类型：DWORD

本地计算机上的 UDP 终结点的端口号。此成员按网络字节顺序存储。

dwOwningPid

类型：DWORD

对 UDP 终结点的绑定函数发出调用的进程 PID。当 PID 不可用时，此成员设置为 0。

liCreateTimestamp

类型： LARGE_INTEGER

一个 FILETIME 结构，指示何时调用 UDP 终结点的绑定函数。

SpecificPortBind

类型： int

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

dwFlags

类型： int

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

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

类型： ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

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

注解

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

dwLocalAddr 成员以与 in_addr 结构相同的格式存储为 DWORD。若要使用 dwLocalAddr 成员，可能需要 Windows 套接字中的 ntohl 或 inet_ntoa 函数或类似函数。在 Windows Vista 及更高版本上， RtlIpv4AddressToString 或 RtlIpv4AddressToStringEx 函数可用于在不加载 Windows 套接字 DLL 的情况下将 dwLocalAddr 成员中的 IPv4 地址转换为字符串。

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

MIB_UDPTABLE_OWNER_MODULE 结构包含本地计算机上 IPv4 的 UDP 侦听器表。该名称基于 IETF 发布的 RFC 1213 中此表的定义。有关详细信息，请参阅 http://www.ietf.org/rfc/rfc1213.txt。此表包含已绑定到地址的 IPv4 的 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)