GetIfEntry2Ex function

The GetIfEntry2Ex function retrieves the specified level of information for the specified interface on the local computer.

Syntax


NETIOAPI_API GetIfEntry2Ex(
  _In_    MIB_IF_ENTRY_LEVEL Level,
  _Inout_ PMIB_IF_ROW2       Row
);

Parameters

Level [in]

The level of interface information to retrieve. This parameter can be one of the values from the MIB_IF_ENTRY_LEVEL enumeration type defined in the Netioapi.h header file.

ValueMeaning
MibIfEntryNormal
0

The values of statistics and state returned in members of the MIB_IF_ROW2 structure pointed to by the Row parameter are returned from the top of the filter stack.

MibIfEntryNormalWithoutStatistics
2

The values of state (without statistics) returned in members of the MIB_IF_ROW2 structure pointed to by the Row parameter are returned from the top of the filter stack.

 

Row [in, out]

A pointer to a MIB_IF_ROW2 structure that, on successful return, receives information for an interface on the local computer. On input, the InterfaceLuid or the InterfaceIndex member of the MIB_IF_ROW2 must be set to the interface for which to retrieve information.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Return codeDescription
ERROR_FILE_NOT_FOUND

The system cannot find the file specified. This error is returned if the network interface LUID or interface index specified by the InterfaceLuid or InterfaceIndex member of the MIB_IF_ROW2 pointed to by the Row parameter was not a value on the local machine.

ERROR_INVALID_PARAMETER

An invalid parameter was passed to the function. This error is returned if a NULL parameter is passed in the Row parameter. This error is also returned if the both the InterfaceLuid and InterfaceIndex member of the MIB_IF_ROW2 pointed to by the Row parameter are unspecified.

Other

Use the FormatMessage function to obtain the message string for the returned error.

 

Remarks

The GetIfEntry2Ex function retrieves information for a specified interface on a local system and returns this information in a pointer to a MIB_IF_ROW2 structure. GetIfEntry2Ex is an enhanced version of the GetIfEntry2 function that allows selecting the level of interface information to retrieve.

On input, at least one of the following members in the MIB_IF_ROW2 structure passed in the Row parameter must be initialized: InterfaceLuid or InterfaceIndex. The fields are used in the order listed above. So if the InterfaceLuid is specified, then this member is used to determine the interface. If no value was set for the InterfaceLuid member (the value of this member was set to zero), then the InterfaceIndex member is next used to determine the interface.

On output, the remaining fields of the MIB_IF_ROW2 structure pointed to by the Row parameter are filled in.

Note that the Netioapi.h header file is automatically included in Iphlpapi.h header file, and should never be used directly.

Requirements

Minimum supported client

Windows 10, version 1703 [desktop apps only]

Minimum supported server

Windows Server 2016 [desktop apps only]

Header

Netioapi.h (include Iphlpapi.h)

Library

Iphlpapi.lib

DLL

Iphlpapi.dll

See also

GetIfEntry
GetIfEntry2
GetIfTable
GetIfTable2
GetIfTable2Ex
IP Helper Function Reference
MIB_IFROW
MIB_IFTABLE
MIB_IF_ROW2
MIB_IF_TABLE2

 

 

Show: