MIB_IFTABLE structure

The MIB_IFTABLE structure contains a table of interface entries.

Syntax


typedef struct _MIB_IFTABLE {
  DWORD     dwNumEntries;
  MIB_IFROW table[ANY_SIZE];
} MIB_IFTABLE, *PMIB_IFTABLE;

Members

dwNumEntries

The number of interface entries in the array.

table

An array of MIB_IFROW structures containing interface entries.

Remarks

The GetIfTable function enumerates the interface entries on a local system and returns this information in a MIB_IFTABLE structure.

The MIB_IFTABLE structure may contain padding for alignment between the dwNumEntries member and the first MIB_IFROW array entry in the table member. Padding for alignment may also be present between the MIB_IFROW array entries in the table member. Any access to a MIB_IFROW array entry should assume padding may exist.

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ifmib.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

GetIfTable
GetIfTable2
GetIfTable2Ex
MIB_IF_ROW2
MIB_IF_TABLE2
MIB_IFNUMBER
MIB_IFROW

 

 

Show: