MIB_UDP6ROW structure (udpmib.h)

The MIB_UDP6ROW structure contains an entry from the User Datagram Protocol (UDP) listener table for IPv6 on the local computer.

Syntax

typedef struct _MIB_UDP6ROW {
  IN6_ADDR dwLocalAddr;
  DWORD    dwLocalScopeId;
  DWORD    dwLocalPort;
} MIB_UDP6ROW, *PMIB_UDP6ROW;

Members

dwLocalAddr

The IPv6 address of the UDP endpoint on the local computer. 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 computer.

dwLocalScopeId

The scope ID for the IPv6 address of the UDP endpoint on the local computer. This member is stored in network byte order.

dwLocalPort

The port number of the UDP endpoint on the local computer. This member is stored in network byte order.

Remarks

The MIB_UDP6ROW structure is defined on Windows Vista and later.

The GetUdp6Table function retrieves the UDP listener table for IPv6 on the local computer and returns this information in a MIB_UDP6TABLE structure.

An array of MIB_UDP6ROW structures are contained in the MIB_UDP6TABLE structure.

The dwLocalAddr member is stored in an in6_addr structure. The RtlIpv6AddressToString or RtlIpv6AddressToStringEx functions may be used to convert the IPv6 address in the dwLocalAddr member to a string without loading the Windows Sockets DLL.

The dwLocalScopeId and dwLocalPort members are in network byte order. In order to use the dwLocalScopeId and dwLocalPort members, the ntohs or inet_ntoa functions in Windows Sockets or similar functions may be needed.

The MIB_UDP6TABLE structure contains the UDP listener table for IPv6 on the local computer. The name is based on the definition of this table in RFC 2454 published by the IETF. For more information, see http://www.ietf.org/rfc/rfc2454.txt. 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, with no intention of receiving packets using this socket (functioning as a listener).

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header udpmib.h (include Iphlpapi.h)

See also

GetUdp6Table

GetUdpTable

MIB_UDP6TABLE

MIB_UDPROW

MIB_UDPTABLE

RtlIpv6AddressToString

RtlIpv6AddressToStringEx

bind

in6_addr

inet_ntoa

ntohl

ntohs