GetIfTable2 - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// netioapi.h
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
View the official Windows hardware development documentationNo description available.
The GetIfTable2 function retrieves the MIB-II interface table.
GetIfTable2 returns STATUS_SUCCESS if the function succeeds.
If the function fails, GetIfTable2 returns one of the following error codes:
| Return code | Description |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | Insufficient memory resources are available to complete the operation. |
| Other | Use the FormatMessage function to obtain the message string for the returned error. |
The GetIfTable2 function enumerates the logical and physical interfaces on a local computer and returns this information in a MIB_IF_TABLE2 structure.
Your driver can use a similar function, GetIfTable2Ex, to specify the level of interfaces to return. A call to the GetIfTable2Ex function with the Level parameter set to MibIfTableNormal retrieves the same results as calling the GetIfTable2 function.
GetIfTable2 returns interfaces in a MIB_IF_TABLE2 structure in the buffer that the Table parameter points to. The MIB_IF_TABLE2 structure contains an interface count and an array of MIB_IF_ROW2 structures for each interface. GetIfTable2 allocates memory for the MIB_IF_TABLE2 structure and the MIB_IF_ROW2 entries in this structure. When these returned structures are no longer required, your driver should free the memory by calling FreeMibTable.
Note that the returned MIB_IF_TABLE2 structure that the Table parameter points to might contain padding for alignment between the NumEntries member and the first MIB_IF_ROW2 array entry in the Table member of the MIB_IF_TABLE2 structure. Padding for alignment might also be present between the MIB_IF_ROW2 array entries. Any access to a MIB_IF_ROW2 array entry should assume padding may exist.
| Target platform | Universal |
| Version | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | Netioapi.h (include Netioapi.h) |
| Library | Netio.lib |
| IRQL | < DISPATCH_LEVEL |