Share via

MIB_UDP6ROW_OWNER_PID (Compact 7)

  • Article

3/12/2014

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

Syntax

typedef struct _MIB_UDP6ROW_OWNER_PID {
  UCHAR ucLocalAddr[16];
  DWORD dwLocalScopeId;
  DWORD dwLocalPort;
  DWORD dwOwningPid;
} MIB_UDP6ROW_OWNER_PID,
  *PMIB_UDP6ROW_OWNER_PID;

Members

  • ucLocalAddr
    The IPv6 address for the local UDP endpoint. This member is stored in a character array in network byte order.

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

  • dwLocalScopeId
    The scope ID for the IPv6 address of the UDP endpoint on the local device. This member is stored in network byte order.
  • 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 a context bind for this endpoint. If this value is set to 0, the information for this endpoint is unavailable.

Remarks

The MIB_UDP6TABLE_OWNER_PID structure is returned by a call to GetExtendedUdpTable with the TableClass parameter set to a UDP_TABLE_OWNER_PID from the UDP_TABLE_CLASS enumeration and the ulAf parameter set to AF_INET6. The MIB_UDP6TABLE_OWNER_PID structure contains an array of MIB_UDP6ROW_OWNER_PID structures.

The ucLocalAddr member is stored in a character array in network byte order.

The dwLocalScopeId member is in network byte order. In order to use the dwLocalScopeId member, the ntohl or inet_ntoa functions in Windows Sockets or similar functions may be needed.

The dwLocalPort members are 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_UDP6TABLE_OWNER_PID structure contains the UDP listener table for IPv6 on the local device. The name is based on the definition of this table in RFC 2454 published by the IETF. This table contains UDP endpoints for IPv6 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
inet_ntoa
MIB_UDP6TABLE_OWNER_PID
ntohl
ntohs
RtlIpv6AddressToString
RtlIpv6AddressToStringEx
UDP_TABLE_CLASS