Export (0) Print
Expand All
Expand Minimize

MIB_IPADDRROW structure

The MIB_IPADDRROWspecifies information for a particular IPv4 address in the MIB_IPADDRTABLE structure.

Syntax


typedef struct _MIB_IPADDRROW {
  DWORD          dwAddr;
  DWORD          dwIndex;
  DWORD          dwMask;
  DWORD          dwBCastAddr;
  DWORD          dwReasmSize;
  unsigned short unused1;
  unsigned short wType;
} MIB_IPADDRROW, *PMIB_IPADDRROW;

Members

dwAddr

Type: DWORD

The IPv4 address in network byte order.

dwIndex

Type: DWORD

The index of the interface associated with this IPv4 address.

dwMask

Type: DWORD

The subnet mask for the IPv4 address in network byte order.

dwBCastAddr

Type: DWORD

The broadcast address in network byte order. A broadcast address is typically the IPv4 address with the host portion set to either all zeros or all ones.

The proper value for this member is not returned by the GetIpAddrTable function.

dwReasmSize

Type: DWORD

The maximum re-assembly size for received datagrams.

unused1

Type: unsigned short

This member is reserved.

wType

Type: unsigned short

The address type or state. This member can be a combination of the following values.

ValueMeaning
MIB_IPADDR_PRIMARY
0x0001

Primary IP address

MIB_IPADDR_DYNAMIC
0x0004

Dynamic IP address

MIB_IPADDR_DISCONNECTED
0x0008

Address is on disconnected interface

MIB_IPADDR_DELETED
0x0040

Address is being deleted

MIB_IPADDR_TRANSIENT
0x0080

Transient address

 

Remarks

On Windows XP and later, the dwIndex member of the MIB_IPADDRROW structure has a data type of IF_INDEX. The wType member is only available on Windows XP and later. On Windows 2000 and earlier, this member is defined as Unused2.

The GetIpAddrTable function retrieves the interface–to–IPv4 address mapping table on a local computer and returns this information in an MIB_IPADDRTABLE structure. The table member in the MIB_IPADDRTABLE structure contains an array of MIB_IPADDRROW entries.

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

Examples

To view an example that retrieves the MIB_IPADDRTABLE structure and then prints out the MIB_IPADDRROW structures in this table, see the GetIpAddrTable function.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ipmib.h on Windows Server 2008 and Windows Vista (include Iphlpapi.h);
Iprtrmib.h on Windows Server 2003, Windows XP, and Windows 2000 (include Iphlpapi.h)

See also

GetIpAddrTable
MIB_IPADDRTABLE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft