MIB_IFROW estructura (ifmib.h)
La estructura MIB_IFROW almacena información sobre una interfaz determinada.
Sintaxis
typedef struct _MIB_IFROW {
WCHAR wszName[MAX_INTERFACE_NAME_LEN];
IF_INDEX dwIndex;
IFTYPE dwType;
DWORD dwMtu;
DWORD dwSpeed;
DWORD dwPhysAddrLen;
UCHAR bPhysAddr[MAXLEN_PHYSADDR];
DWORD dwAdminStatus;
INTERNAL_IF_OPER_STATUS dwOperStatus;
DWORD dwLastChange;
DWORD dwInOctets;
DWORD dwInUcastPkts;
DWORD dwInNUcastPkts;
DWORD dwInDiscards;
DWORD dwInErrors;
DWORD dwInUnknownProtos;
DWORD dwOutOctets;
DWORD dwOutUcastPkts;
DWORD dwOutNUcastPkts;
DWORD dwOutDiscards;
DWORD dwOutErrors;
DWORD dwOutQLen;
DWORD dwDescrLen;
UCHAR bDescr[MAXLEN_IFDESCR];
} MIB_IFROW, *PMIB_IFROW;
Miembros
wszName[MAX_INTERFACE_NAME_LEN]
Tipo: WCHAR[MAX_INTERFACE_NAME_LEN]
Puntero a una cadena Unicode que contiene el nombre de la interfaz.
dwIndex
Tipo: DWORD
Índice que identifica la interfaz. Este valor de índice puede cambiar cuando un adaptador de red está deshabilitado y, a continuación, habilitado, y no debe considerarse persistente.
dwType
Tipo: DWORD
Tipo de interfaz tal y como se define en internet Assigned Names Authority (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.
dwMtu
Tipo: DWORD
Tamaño máximo de unidad de transmisión (MTU) en bytes.
dwSpeed
Tipo: DWORD
Velocidad de la interfaz en bits por segundo.
dwPhysAddrLen
Tipo: DWORD
Longitud, en bytes, de la dirección física especificada por el miembro bPhysAddr .
bPhysAddr[MAXLEN_PHYSADDR]
Tipo: BYTE[MAXLEN_PHYSADDR]
Dirección física del adaptador para esta interfaz.
dwAdminStatus
Tipo: DWORD
La interfaz está habilitada o deshabilitada administrativamente.
dwOperStatus
Tipo: DWORD
Estado operativo de la interfaz. Este miembro puede ser uno de los siguientes valores definidos en la enumeración INTERNAL_IF_OPER_STATUS definida en el archivo de encabezado Ipifcons.h .
dwLastChange
Tipo: DWORD
El período de tiempo, en centésimas de segundos (10^-2 s), comenzando desde el último reinicio del equipo, cuando la interfaz entró en su estado operativo actual. Este valor se revierte después de 2^32 centésimas de segundo.
El miembro dwLastChange no es compatible actualmente con NDIS. En Windows Vista y versiones posteriores, NDIS devuelve cero para este miembro. En versiones anteriores de Windows, se devuelve un valor arbitrario en este miembro para las interfaces compatibles con NDIS. En el caso de las interfaces compatibles con otros proveedores de interfaz, pueden devolver un valor adecuado.
dwInOctets
Tipo: DWORD
Número de octetos de datos recibidos a través de esta interfaz.
dwInUcastPkts
Tipo: DWORD
Número de paquetes de unidifusión recibidos a través de esta interfaz.
dwInNUcastPkts
Tipo: DWORD
Número de paquetes que no son de unidifusión recibidos a través de esta interfaz. Se incluyen paquetes de difusión y multidifusión.
dwInDiscards
Tipo: DWORD
Número de paquetes entrantes que se descartaron aunque no tuvieran errores.
dwInErrors
Tipo: DWORD
Número de paquetes entrantes que se descartaron debido a errores.
dwInUnknownProtos
Tipo: DWORD
Número de paquetes entrantes que se descartaron porque el protocolo era desconocido.
dwOutOctets
Tipo: DWORD
Número de octetos de datos enviados a través de esta interfaz.
dwOutUcastPkts
Tipo: DWORD
Número de paquetes de unidifusión enviados a través de esta interfaz.
dwOutNUcastPkts
Tipo: DWORD
Número de paquetes que no son de unidifusión enviados a través de esta interfaz. Se incluyen paquetes de difusión y multidifusión.
dwOutDiscards
Tipo: DWORD
Número de paquetes salientes que se descartaron aunque no tuvieran errores.
dwOutErrors
Tipo: DWORD
Número de paquetes salientes que se descartaron debido a errores.
dwOutQLen
Tipo: DWORD
Longitud de la cola de transmisión. Este campo no se usa actualmente.
dwDescrLen
Tipo: DWORD
Longitud, en bytes, del miembro bDescr .
bDescr[MAXLEN_IFDESCR]
Tipo: BYTE[MAXLEN_IFDESCR]
Descripción de la interfaz.
Comentarios
El miembro dwSpeed de la estructura MIB_IFROW será incorrecto para las interfaces de red de alta velocidad (adaptador de red de 10 Gbit/s, por ejemplo), ya que el valor máximo que se puede almacenar en un DWORD es 4.294.967.295. Las aplicaciones deben usar la estructura de MIB_IF_ROW2 devuelta por las funciones GetIfEntry2 y GetIfTable2 o la estructura de IP_ADAPTER_ADDRESSES devuelta por la función GetAdaptersAddresses para determinar la velocidad de las interfaces de red de alta velocidad.
En Microsoft Kit de desarrollo de software de Windows (SDK) publicado para Windows Vista y versiones posteriores, la organización de archivos de encabezado ha cambiado y la estructura de MIB_IFROW se define en el archivo de encabezado Ifmib.h no en el archivo de encabezado Iprtrmib.h. Tenga en cuenta que el archivo de encabezado Ifmib.h se incluye automáticamente en Iprtrmib.h , que se incluye automáticamente en el archivo de encabezado Iphlpapi.h . Los archivos de encabezado Ifmib.h e Iprtrmib.h nunca deben usarse directamente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | ifmib.h (incluya Iphlpapi.h) |