Partager via

MIB_UDPROW_OWNER_MODULE (Compact 7)

  • Article

3/12/2014

This structure contains an entry from the IPv4 User Datagram Protocol (UDP) listener table on the local device. This entry also includes any available ownership data and the process ID (PID) that issued the call to the bind function for the UDP endpoint.

Syntax

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_UDPRPW_OWNER_MODULE;

Members

  • dwLocalAddr
    The IPv4 address of the UDP endpoint on the local device.

    A value of zero indicates a UDP listener willing to accept datagrams for any IP interface associated with the local device.

  • dwLocalPort
    The port number of the UDP endpoint on the local device. This member is stored in network byte order.
  • dwOwningPid
    The PID of the process that issued the call to the bind function for the UDP endpoint. This member is set to 0 when the PID is unavailable.
  • liCreateTimestamp
    A system time value which indicates when the call to the bind function for the UDP endpoint occurred.
  • SpecificPortBind
    A value that indicates if a specific port was specified in the last context bind operation.
  • dwFlags
    A set of flags. This member is currently not used.
  • OwningModuleInfo
    An array of opaque data that contains ownership information.

Remarks

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

The dwLocalAddr member is stored as a DWORD in the same format as the in_addr structure. In order to use the dwLocalAddr member, the ntohl or inet_ntoa functions in Windows Sockets or similar functions might be needed. The dwLocalPort member is in network byte order. In order to use the dwLocalPort member, the ntohs or inet_ntoa functions in Windows Sockets or similar functions might be needed.

The MIB_UDPTABLE_OWNER_MODULE structure contains the UDP listener table for IPv4 on the local device. The name is based on the definition of this table in RFC 1213 published by the IETF. 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, without an intention of receiving packets by using this socket (functioning as a listener).

Requirements

Header

ws2def.h,
ws2ipdef.h

See Also

Reference

MIB Structures
GetExtendedUdpTable
GetUdp6Table
GetUdpTable
in_addr
inet_ntoa
MIB_UDP6ROW_OWNER_MODULE
MIB_UDP6TABLE_OWNER_MODULE
MIB_UDPTABLE_OWNER_MODULE
ntohl
ntohs
RtlIpv4AddressToString
RtlIpv4AddressToStringEx