GetIpInterfaceEntry
DWORD GetIpInterfaceEntry(
PMIB_IPINTERFACE_ROW Row
);
Parameters
| Parameter | Description |
|---|---|
Row |
A pointer to a MIB_IPINTERFACE_ROW structure that specifies the IP interface properties to retrieve.
The structure must be initialized with the interface index.
|
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.
ERROR_INVALID_PARAMETER: The input parameter is invalid.ERROR_NOT_FOUND: The specified interface does not exist.ERROR_INVALID_INDEX: The interface index is invalid.
Remarks
On Windows Vista and later, the GetIpInterfaceEntry function is used to retrieve information for a specific IP interface.
To retrieve information for all IP interfaces, use the GetIpInterfaceTable function.
The caller must initialize the InterfaceIndex member of the MIB_IPINTERFACE_ROW structure before calling this function.
The returned MIB_IPINTERFACE_ROW structure contains various details about the IP interface, including its state, metrics, and unicast/multicast capabilities.