Función GetIfEntry2
La función GetIfEntry2 recupera información de la interfaz especificada en un equipo local.
Importante
Para los desarrolladores de controladores, se recomienda usar GetIfEntry2Ex con MibIfEntryNormalWithoutStatistics siempre que sea posible, con el fin de evitar un interbloqueo al atender los OID de NDIS.
Sintaxis
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
Parámetros
- Row [in, out]
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 controlador debe establecer el miembro InterfaceLuid o el miembro InterfaceIndex de la estructura MIB_IF_ROW2 en la interfaz para la que recuperar información.
Valor devuelto
GetIfEntry2 devuelve STATUS_SUCCESS si la función se ejecuta correctamente.
Si se produce un error en la función, GetIfEntry2 devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Se ha transferido un parámetro no válido a la función. Este error se devuelve si se transfiere un puntero NULL al parámetro Row. |
| STATUS_NOT_FOUND | No se encuentra la interfaz especificada. Este error se devuelve si la función no encuentra la interfaz de red especificada por el miembro InterfaceLuid o InterfaceIndex de la estructura MIB_IF_ROW2 a la que apunta el parámetro Row. |
| Otros | Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Comentarios
En la entrada, el controlador debe inicializar al menos el miembro InterfaceLuid o InterfaceIndex en la estructura MIB_IF_ROW2 que se transfiere al parámetro Row. Los miembros 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, los campos restantes de la estructura MIB_IF_ROW2 a la que apunta el parámetro Row se rellenan.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluye Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |