estructura MIB_IF_ROW2 (netioapi.h)
La estructura MIB_IF_ROW2 almacena información sobre una interfaz determinada.
Sintaxis
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface : 1;
BOOLEAN FilterInterface : 1;
BOOLEAN ConnectorPresent : 1;
BOOLEAN NotAuthenticated : 1;
BOOLEAN NotMediaConnected : 1;
BOOLEAN Paused : 1;
BOOLEAN LowPower : 1;
BOOLEAN EndPointInterface : 1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Miembros
InterfaceLuid
Tipo: NET_LUID
Identificador único local (LUID) de la interfaz de red.
InterfaceIndex
Tipo: NET_IFINDEX
Índice que identifica la interfaz de red. Este valor de índice puede cambiar cuando un adaptador de red está deshabilitado y, a continuación, habilitado, y no debe considerarse persistente.
InterfaceGuid
Tipo: GUID
GUID de la interfaz de red.
Alias[IF_MAX_STRING_SIZE + 1]
Tipo: WCHAR[IF_MAX_STRING_SIZE + 1]
Cadena Unicode terminada en NULL que contiene el nombre de alias de la interfaz de red.
Description[IF_MAX_STRING_SIZE + 1]
Tipo: WCHAR[IF_MAX_STRING_SIZE + 1]
Cadena Unicode terminada en NULL que contiene una descripción de la interfaz de red.
PhysicalAddressLength
Tipo: ULONG
Longitud, en bytes, de la dirección de hardware física especificada por el miembro PhysicalAddress .
PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Tipo: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Dirección de hardware físico del adaptador para esta interfaz de red.
PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Tipo: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Dirección de hardware físico permanente del adaptador para esta interfaz de red.
Mtu
Tipo: ULONG
Tamaño máximo de la unidad de transmisión (MTU), en bytes, para esta interfaz de red.
Type
Tipo: IFTYPE
Tipo de interfaz definido por la Autoridad de nombres asignados a Internet (IANA). Para obtener más información, vea http://www.iana.org/assignments/ianaiftype-mib. Los valores posibles para el tipo de interfaz se enumeran en el archivo de encabezado Ipifcons.h .
En la tabla siguiente se enumeran los valores comunes para el tipo de interfaz, aunque muchos otros valores son posibles.
TunnelType
Tipo: TUNNEL_TYPE
Método de encapsulación utilizado por un túnel si el miembro Type es IF_TYPE_TUNNEL. El tipo de túnel se define mediante la Autoridad de nombres asignados a Internet (IANA). Para obtener más información, vea http://www.iana.org/assignments/ianaiftype-mib. Este miembro puede ser uno de los valores del tipo de enumeración TUNNEL_TYPE definido en el archivo de encabezado Ifdef.h .
MediaType
Tipo: NDIS_MEDIUM
Tipo de medio NDIS para la interfaz. Este miembro puede ser uno de los valores del tipo de enumeración NDIS_MEDIUM definido en el archivo de encabezado Ntddndis.h .
PhysicalMediumType
Tipo: NDIS_PHYSICAL_MEDIUM
Tipo medio físico NDIS. Este miembro puede ser uno de los valores del tipo de enumeración NDIS_PHYSICAL_MEDIUM definido en el archivo de encabezado Ntddndis.h .
AccessType
Tipo: NET_IF_ACCESS_TYPE
Tipo de acceso de interfaz. Este miembro puede ser uno de los valores del tipo de enumeración NET_IF_ACCESS_TYPE definido en el archivo de encabezado Ifdef.h .
DirectionType
Tipo: NET_IF_DIRECTION_TYPE
Tipo de dirección de la interfaz. Este miembro puede ser uno de los valores del tipo de enumeración NET_IF_DIRECTION_TYPE definido en el archivo de encabezado Ifdef.h .
InterfaceAndOperStatusFlags
Conjunto de marcas que proporcionan información sobre la interfaz. Estas marcas se combinan con una operación OR bit a bit. Si no se aplica ninguna de las marcas, este miembro se establece en cero.
InterfaceAndOperStatusFlags.HardwareInterface
Tipo: BOOLEAN Establezca si la interfaz de red es para hardware.
InterfaceAndOperStatusFlags.FilterInterface
Tipo: BOOLEAN Establezca si la interfaz de red es para un módulo de filtro.
InterfaceAndOperStatusFlags.ConnectorPresent
Tipo: BOOLEAN Establezca si un conector está presente en la interfaz de red. Este valor se establece si hay un adaptador de red físico.
InterfaceAndOperStatusFlags.NotAuthenticated
Tipo: BOOLEAN Establezca si el puerto predeterminado de la interfaz de red no está autenticado. Si el destino no autentica una interfaz de red, la interfaz de red no está en modo operativo. Aunque esto se aplica a las conexiones de red cableadas e inalámbricas, la autenticación es más común para las conexiones de red inalámbrica.
InterfaceAndOperStatusFlags.NotMediaConnected
Tipo: BOOLEAN Establezca si la interfaz de red no está en un estado conectado a medios. Si un cable de red está desconectado para una red cableada, se establecerá. Para una red inalámbrica, se establece para el adaptador de red que no está conectado a una red.
InterfaceAndOperStatusFlags.Paused
Tipo: BOOLEAN Establezca si la pila de red de la interfaz de red está en pausa o en estado de pausa. Esto no significa que el equipo esté en estado hibernado.
InterfaceAndOperStatusFlags.LowPower
Tipo: BOOLEAN Establezca si la interfaz de red está en un estado de bajo consumo.
InterfaceAndOperStatusFlags.EndPointInterface
Tipo: BOOLEAN Establezca si la interfaz de red es un dispositivo de punto de conexión y no una interfaz de red verdadera que se conecta a una red. Esto se puede establecer mediante dispositivos como teléfonos inteligentes que usan la infraestructura de red para comunicarse con el equipo, pero no proporcionan conectividad a una red externa. Es obligatorio que estos tipos de dispositivos establezcan esta marca.
OperStatus
Tipo: IF_OPER_STATUS
El estado operativo de la interfaz tal como se define en RFC 2863 como IfOperStatus. Para obtener más información, vea http://www.ietf.org/rfc/rfc2863.txt. Este miembro puede ser uno de los valores del tipo de enumeración IF_OPER_STATUS definido en el archivo de encabezado Ifdef.h .
AdminStatus
Tipo: NET_IF_ADMIN_STATUS
Estado administrativo de la interfaz tal como se define en RFC 2863. Para obtener más información, vea http://www.ietf.org/rfc/rfc2863.txt. Este miembro puede ser uno de los valores del tipo de enumeración NET_IF_ADMIN_STATUS definido en el archivo de encabezado Ifdef.h .
MediaConnectState
Tipo: NET_IF_MEDIA_CONNECT_STATE
Estado de conexión de la interfaz. Este miembro puede ser uno de los valores del tipo de enumeración NET_IF_MEDIA_CONNECT_STATE definido en el archivo de encabezado Ifdef.h .
NetworkGuid
Tipo: NET_IF_NETWORK_GUID
GUID asociado a la red a la que pertenece la interfaz.
ConnectionType
Tipo: NET_IF_CONNECTION_TYPE
Tipo de conexión de interfaz de red NDIS. Este miembro puede ser uno de los valores del tipo de enumeración NET_IF_CONNECTION_TYPE definido en el archivo de encabezado Ifdef.h .
TransmitLinkSpeed
Tipo: ULONG64
Velocidad en bits por segundo del enlace de transmisión.
ReceiveLinkSpeed
Tipo: ULONG64
Velocidad en bits por segundo del vínculo de recepción.
InOctets
Tipo: ULONG64
Número de octetos de datos recibidos sin errores a través de esta interfaz. Este valor incluye octetos en paquetes de unidifusión, difusión y multidifusión.
InUcastPkts
Tipo: ULONG64
Número de paquetes de unidifusión recibidos sin errores a través de esta interfaz.
InNUcastPkts
Tipo: ULONG64
Número de paquetes que no son de unidifusión recibidos sin errores a través de esta interfaz. Este valor incluye paquetes de difusión y multidifusión.
InDiscards
Tipo: ULONG64
Número de paquetes entrantes que se eligieron para descartarse aunque no se detectara ningún error para evitar que los paquetes se entregan a un protocolo de capa superior.
InErrors
Tipo: ULONG64
Número de paquetes entrantes que se descartaron debido a errores.
InUnknownProtos
Tipo: ULONG64
Número de paquetes entrantes que se descartaron porque el protocolo era desconocido.
InUcastOctets
Tipo: ULONG64
Número de octetos de datos recibidos sin errores en paquetes de unidifusión a través de esta interfaz.
InMulticastOctets
Tipo: ULONG64
Número de octetos de datos recibidos sin errores en paquetes de multidifusión a través de esta interfaz.
InBroadcastOctets
Tipo: ULONG64
Número de octetos de datos recibidos sin errores en paquetes de difusión a través de esta interfaz.
OutOctets
Tipo: ULONG64
Número de octetos de datos transmitidos sin errores a través de esta interfaz. Este valor incluye octetos en paquetes de unidifusión, difusión y multidifusión.
OutUcastPkts
Tipo: ULONG64
Número de paquetes de unidifusión transmitidos sin errores a través de esta interfaz.
OutNUcastPkts
Tipo: ULONG64
Número de paquetes que no son de unidifusión transmitidos sin errores a través de esta interfaz. Este valor incluye paquetes de difusión y multidifusión.
OutDiscards
Tipo: ULONG64
Número de paquetes salientes que se descartaron aunque no tuvieran errores.
OutErrors
Tipo: ULONG64
Número de paquetes salientes que se descartaron debido a errores.
OutUcastOctets
Tipo: ULONG64
Número de octetos de datos transmitidos sin errores en paquetes de unidifusión a través de esta interfaz.
OutMulticastOctets
Tipo: ULONG64
Número de octetos de datos transmitidos sin errores en paquetes de multidifusión a través de esta interfaz.
OutBroadcastOctets
Tipo: ULONG64
Número de octetos de datos transmitidos sin errores en paquetes de difusión a través de esta interfaz.
OutQLen
Tipo: ULONG64
Longitud de la cola de transmisión. Este campo no se usa actualmente.
Comentarios
La estructura MIB_IF_ROW2 se define en Windows Vista y versiones posteriores.
Los valores del campo Tipo se definen en el archivo de encabezado Ipifcons.h . Actualmente solo se admiten los valores posibles enumerados en la descripción del miembro Type .
Tenga en cuenta que el archivo de encabezado Netioapi.h se incluye automáticamente en el archivo de encabezado Iphlpapi.h . El archivo de encabezado Netioapi.h nunca debe usarse directamente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | netioapi.h (include Iphlpapi.h) |