Función GetIfEntry2Ex (netioapi.h)

Artículo
08/25/2023

La función GetIfEntry2Ex recupera el nivel de información especificado para la interfaz especificada en el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfEntry2Ex(
  [in]      MIB_IF_ENTRY_LEVEL Level,
  [in, out] PMIB_IF_ROW2       Row
);

Parámetros

[in] Level

Nivel de información de interfaz que se va a recuperar. Este parámetro puede ser uno de los valores del tipo de enumeración MIB_IF_ENTRY_LEVEL definido en el archivo de encabezado Netioapi.h .

Valor	Significado
MibIfEntryNormal 0	Los valores de estadísticas y estado devueltos en los miembros de la estructura MIB_IF_ROW2 a la que apunta el parámetro Row se devuelven desde la parte superior de la pila de filtros.
MibIfEntryNormalWithoutStatistics 2	Los valores de estado (sin estadísticas) devueltos en los miembros de la estructura MIB_IF_ROW2 a la que apunta el parámetro Row se devuelven desde la parte superior de la pila de filtros.

[in, out] Row

Puntero a una estructura MIB_IF_ROW2 que, al devolverse correctamente, recibe información de una interfaz en el equipo local. En la entrada, el miembro InterfaceLuid o InterfaceIndex del MIB_IF_ROW2 debe establecerse en la interfaz para la que se va a recuperar información.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_FILE_NOT_FOUND	El sistema no encuentra el archivo especificado. Este error se devuelve si el LUID de interfaz de red o el índice de interfaz especificado por el miembro InterfaceLuid o InterfaceIndex del MIB_IF_ROW2 señalado por el parámetro Row no era un valor en el equipo local.
ERROR_INVALID_PARAMETER	Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un parámetro NULL en el parámetro Row . Este error también se devuelve si el miembro InterfaceLuid y InterfaceIndex del MIB_IF_ROW2 al que apunta el parámetro Row no están especificados.
Otros	Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

The
La función GetIfEntry2Ex recupera información de una interfaz especificada en un sistema local y devuelve esta información en un puntero a un
MIB_IF_ROW2 estructura. GetIfEntry2Ex es una versión mejorada de la función GetIfEntry2 que permite seleccionar el nivel de información de interfaz que se va a recuperar.

En la entrada, se debe inicializar al menos uno de los siguientes miembros de la estructura MIB_IF_ROW2 pasada en el parámetro Row : InterfaceLuid o InterfaceIndex.

Los campos se usan en el orden indicado anteriormente. Por lo tanto, si se especifica InterfaceLuid , este miembro se usa para determinar la interfaz. Si no se estableció ningún valor para el miembro InterfaceLuid (el valor de este miembro se estableció en cero), el miembro InterfaceIndex se usará a continuación para determinar la interfaz.

En la salida, se rellenan los campos restantes de la estructura MIB_IF_ROW2 a la que apunta el parámetro Row .

Tenga en cuenta que el archivo de encabezado Netioapi.h se incluye automáticamente en el archivo de encabezado Iphlpapi.h y nunca se debe usar directamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netioapi.h (include Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll