MIB_UDPTABLE_OWNER_MODULE structure (udpmib.h)

The MIB_UDPTABLE_OWNER_MODULE structure contains the User Datagram Protocol (UDP) listener table for IPv4 on the local computer. The table also includes any available ownership data and the process ID (PID) that issued the call to the bind function for each UDP endpoint.

Syntax

typedef struct _MIB_UDPTABLE_OWNER_MODULE {
  DWORD                   dwNumEntries;
  MIB_UDPROW_OWNER_MODULE table[ANY_SIZE];
} MIB_UDPTABLE_OWNER_MODULE, *PMIB_UDPTABLE_OWNER_MODULE;

Members

dwNumEntries

The number of MIB_UDPROW_OWNER_MODULE elements in table.

table[ANY_SIZE]

An array of MIB_UDPROW_OWNER_MODULE structures returned by a call to GetExtendedUdpTable.

Remarks

The MIB_UDPTABLE_OWNER_MODULE structure is returned by a call to GetExtendedUdpTable with the TableClass parameter set to UDP_TABLE_OWNER_MODULE from the UDP_TABLE_CLASS enumeration and the ulAf parameter set to AF_INET4. The MIB_UDPTABLE_OWNER_MODULE structure contains an array of MIB_UDPROW_OWNER_MODULE structures.

The MIB_UDPTABLE_OWNER_MODULE structure may contain padding for alignment between the dwNumEntries member and the first MIB_UDPROW_OWNER_MODULE array entry in the table member. Padding for alignment may also be present between the MIB_UDPROW_OWNER_MODULE array entries in the table member. Any access to a MIB_UDPROW_OWNER_MODULE array entry should assume padding may exist.

The MIB_UDPTABLE_OWNER_MODULE structure contains the UDP listener table for IPv4 on the local computer. The name is based on the definition of this table in RFC 1213 published by the IETF. For more information, see http://www.ietf.org/rfc/rfc1213.txt. This table contains UDP endpoints for IPv4 that have been bound to an address. It should be noted that an application can create a UDP socket and bind it to an address for the sole purpose of sending a UDP datagram, with no intention of receiving packets using this socket (functioning as a listener).

The MIB_UDPTABLE_OWNER_MODULE structure is an enhanced version of the MIB_UDPTABLE_OWNER_PID structure that includes any available ownership data for each UDP endpoint in the table. The MIB_UDPTABLE_OWNER_PID is an enhanced version of the MIB_UDPTABLE that includes the process ID (PID) that issued the call to the bind function for each UDP endpoint in the table.

On the Microsoft Windows Software Development Kit (SDK) released for Windows Vista and later, the organization of header files has changed. This structure is defined in the Udpmib.h header file, not in the Iprtrmib.h header file. Note that the Udpmib.h header file is automatically included in Iprtrmib.h, which is automatically included in the Iphlpapi.h header file. The Udpmib.h and Iprtrmib.h header files should never be used directly.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2008, Windows Server 2003 with SP1 [desktop apps only]
Header udpmib.h (include Iphlpapi.h)

See also

GetExtendedUdpTable

GetUdp6Table

GetUdpTable

MIB_UDP6ROW

MIB_UDP6ROW_OWNER_MODULE

MIB_UDP6ROW_OWNER_PID

MIB_UDP6TABLE

MIB_UDP6TABLE_OWNER_MODULE

MIB_UDP6TABLE_OWNER_PID

MIB_UDPROW

MIB_UDPROW_OWNER_MODULE

MIB_UDPROW_OWNER_PID

MIB_UDPTABLE

MIB_UDPTABLE_OWNER_PID

UDP_TABLE_CLASS

bind