Edit

INTERFACE_INFO_EX structure (ws2ipdef.h)

  • Article

The INTERFACE_INFO_EX structure is used in conjunction with the SIO_GET_INTERFACE_LIST IOCTL command to obtain information about an interface IP address. Unlike the INTERFACE_INFO structure, INTERFACE_INFO_EX is address-size independent, enabling it to work with IPv6.

Syntax

typedef struct _INTERFACE_INFO_EX {
  ULONG          iiFlags;
  SOCKET_ADDRESS iiAddress;
  SOCKET_ADDRESS iiBroadcastAddress;
  SOCKET_ADDRESS iiNetmask;
} INTERFACE_INFO_EX, *LPINTERFACE_INFO_EX;

Members

iiFlags

Bitmask describing the status of the interface. The following flags are possible.

Flag Meaning
IFF_UP
 The interface is running.
IFF_BROADCAST
 The broadcast feature is supported.
IFF_LOOPBACK
 The loopback interface is running.
IFF_POINTTOPOINT
 The interface is using point-to-point link.
IFF_MULTICAST
 The multicast feature is supported.

iiAddress

Address of an interface.

iiBroadcastAddress

Broadcast address of the interface or the address of the other side for point-to-point links.

iiNetmask

Netmask used by the interface.

Remarks

On the Microsoft Windows Software Development Kit (SDK) released for Windows Vista and later, the organization of header files has changed and the INTERFACE_INFO_EX structure is defined in the Ws2ipdef.h header file which is automatically included in the Ws2tcpip.h header file. The Ws2ipdef.h header files should never be used directly.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header ws2ipdef.h (include Ws2tcpip.h)

See also

Winsock IOCTLs