estrutura MIB_IFROW (ifmib.h)
A estrutura MIB_IFROW armazena informações sobre uma interface específica.
Sintaxe
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;
Membros
wszName[MAX_INTERFACE_NAME_LEN]
Tipo: WCHAR[MAX_INTERFACE_NAME_LEN]
Um ponteiro para uma cadeia de caracteres Unicode que contém o nome da interface.
dwIndex
Tipo: DWORD
O índice que identifica a interface. Esse valor de índice pode ser alterado quando um adaptador de rede é desabilitado e habilitado e não deve ser considerado persistente.
dwType
Tipo: DWORD
O tipo de interface conforme definido pela IANA (Autoridade de Nomes Atribuídos à Internet). Para obter mais informações, consulte http://www.iana.org/assignments/ianaiftype-mib. Os valores possíveis para o tipo de interface são listados no arquivo de cabeçalho Ipifcons.h .
A tabela a seguir lista valores comuns para o tipo de interface, embora muitos outros valores sejam possíveis.
dwMtu
Tipo: DWORD
O tamanho máximo da MTU (Unidade de Transmissão) em bytes.
dwSpeed
Tipo: DWORD
A velocidade da interface em bits por segundo.
dwPhysAddrLen
Tipo: DWORD
O comprimento, em bytes, do endereço físico especificado pelo membro bPhysAddr .
bPhysAddr[MAXLEN_PHYSADDR]
Tipo: BYTE[MAXLEN_PHYSADDR]
O endereço físico do adaptador para essa interface.
dwAdminStatus
Tipo: DWORD
A interface está habilitada ou desabilitada administrativamente.
dwOperStatus
Tipo: DWORD
O status operacional da interface. Esse membro pode ser um dos seguintes valores definidos na enumeração INTERNAL_IF_OPER_STATUS definida no arquivo de cabeçalho Ipifcons.h .
dwLastChange
Tipo: DWORD
O período de tempo, em centésimos de segundos (10^-2 s), a partir da última reinicialização do computador, quando a interface entrou em seu estado operacional atual. Esse valor é revertida após 2^32 centésimos de segundo.
Atualmente, o membro dwLastChange não tem suporte do NDIS. No Windows Vista e posterior, o NDIS retorna zero para esse membro. Em versões anteriores do Windows, um valor arbitrário é retornado neste membro para as interfaces compatíveis com o NDIS. Para interfaces compatíveis com outros provedores de interface, eles podem retornar um valor apropriado.
dwInOctets
Tipo: DWORD
O número de octetos de dados recebidos por meio dessa interface.
dwInUcastPkts
Tipo: DWORD
O número de pacotes unicast recebidos por meio dessa interface.
dwInNUcastPkts
Tipo: DWORD
O número de pacotes não unicast recebidos por meio dessa interface. Pacotes de difusão e multicast estão incluídos.
dwInDiscards
Tipo: DWORD
O número de pacotes de entrada que foram descartados mesmo que não tenham erros.
dwInErrors
Tipo: DWORD
O número de pacotes de entrada que foram descartados devido a erros.
dwInUnknownProtos
Tipo: DWORD
O número de pacotes de entrada que foram descartados porque o protocolo era desconhecido.
dwOutOctets
Tipo: DWORD
O número de octetos de dados enviados por meio dessa interface.
dwOutUcastPkts
Tipo: DWORD
O número de pacotes unicast enviados por meio dessa interface.
dwOutNUcastPkts
Tipo: DWORD
O número de pacotes não unicast enviados por meio dessa interface. Pacotes de difusão e multicast estão incluídos.
dwOutDiscards
Tipo: DWORD
O número de pacotes de saída que foram descartados mesmo que não tenham erros.
dwOutErrors
Tipo: DWORD
O número de pacotes de saída que foram descartados devido a erros.
dwOutQLen
Tipo: DWORD
O comprimento da fila de transmissão. Este campo não é usado no momento.
dwDescrLen
Tipo: DWORD
O comprimento, em bytes, do membro bDescr .
bDescr[MAXLEN_IFDESCR]
Tipo: BYTE[MAXLEN_IFDESCR]
Uma descrição da interface .
Comentários
O membro dwSpeed da estrutura MIB_IFROW estará incorreto para adaptadores de rede de alta velocidade (adaptador de rede de 10 Gbit/s, por exemplo), pois o valor máximo que pode ser armazenado em um DWORD é 4.294.967.295. Os aplicativos devem usar a estrutura MIB_IF_ROW2 retornada pelas funções GetIfEntry2 e GetIfTable2 ou a estrutura IP_ADAPTER_ADDRESSES retornada pela função GetAdaptersAddresses para determinar a velocidade de interfaces de rede de alta velocidade.
No Microsoft Software Development Kit do Windows (SDK do Windows) (SDK) lançado para Windows Vista e posterior, a organização de arquivos de cabeçalho foi alterada e a estrutura de MIB_IFROW é definida no arquivo de cabeçalho Ifmib.h que não está no arquivo de cabeçalho Iprtrmib.h. Observe que o arquivo de cabeçalho Ifmib.h é incluído automaticamente em Iprtrmib.h , que é incluído automaticamente no arquivo de cabeçalho Iphlpapi.h . Os arquivos de cabeçalho Ifmib.h e Iprtrmib.h nunca devem ser usados diretamente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | ifmib.h (inclua Iphlpapi.h) |