estrutura MIB_IPSTATS_LH (ipmib.h)

A estrutura MIB_IPSTATS armazena informações sobre o protocolo IP em execução em um computador específico.

Sintaxe

typedef struct _MIB_IPSTATS_LH {
  union {
    DWORD                  dwForwarding;
    MIB_IPSTATS_FORWARDING Forwarding;
  };
  DWORD dwDefaultTTL;
  DWORD dwInReceives;
  DWORD dwInHdrErrors;
  DWORD dwInAddrErrors;
  DWORD dwForwDatagrams;
  DWORD dwInUnknownProtos;
  DWORD dwInDiscards;
  DWORD dwInDelivers;
  DWORD dwOutRequests;
  DWORD dwRoutingDiscards;
  DWORD dwOutDiscards;
  DWORD dwOutNoRoutes;
  DWORD dwReasmTimeout;
  DWORD dwReasmReqds;
  DWORD dwReasmOks;
  DWORD dwReasmFails;
  DWORD dwFragOks;
  DWORD dwFragFails;
  DWORD dwFragCreates;
  DWORD dwNumIf;
  DWORD dwNumAddr;
  DWORD dwNumRoutes;
} MIB_IPSTATS_LH, *PMIB_IPSTATS_LH;

Membros

dwForwarding

Tipo: DWORD

Especifica se o encaminhamento de IP está habilitado ou desabilitado para um protocolo (IPv4 ou IPv6).

No Windows Vista e posteriores, esse membro é definido como uma união que contém um membro DWORD dwForwarding e um membro de encaminhamento de MIB_IPSTATS_FORWARDING em que MIB_IPSTATS_FORWARDING é uma enumeração definida no arquivo de cabeçalho Ipmib.h .

Nota Esse membro se aplica a todo o sistema por protocolo (IPv4 ou IPv6) e não retorna por configuração de interface para encaminhamento de IP.
 
Valor Significado
MIB_IP_FORWARDING
1
O encaminhamento de IP está habilitado.
MIB_IP_NOT_FORWARDING
2
O encaminhamento de IP não está habilitado.
MIB_USE_CURRENT_FORWARDING
0xffff
Use a configuração de encaminhamento de IP atual. Esse valor só é aplicável ao definir as opções de encaminhamento e vida útil (TTL) usando as funções SetIpStatistics e SetIpStatisticsEx .

Forwarding

dwDefaultTTL

Tipo: DWORD

O TTL (tempo de vida inicial) padrão para datagramas originados em um computador específico.

Esse membro pode ser definido como MIB_USE_CURRENT_TTL para usar o valor TTL padrão atual ao definir as opções de TTL (encaminhamento e vida útil) usando as funções SetIpStatistics e SetIpStatisticsEx .

dwInReceives

Tipo: DWORD

O número de datagramas recebidos.

dwInHdrErrors

Tipo: DWORD

O número de datagramas recebidos que têm erros de cabeçalho.

dwInAddrErrors

Tipo: DWORD

O número de datagramas recebidos que têm erros de endereço.

dwForwDatagrams

Tipo: DWORD

O número de datagramas encaminhados.

dwInUnknownProtos

Tipo: DWORD

O número de datagramas recebidos que têm um protocolo desconhecido.

dwInDiscards

Tipo: DWORD

O número de datagramas recebidos descartados.

dwInDelivers

Tipo: DWORD

O número de datagramas recebidos entregues.

dwOutRequests

Tipo: DWORD

O número de datagramas de saída que o IP é solicitado a transmitir. Esse número não inclui datagramas encaminhados.

dwRoutingDiscards

Tipo: DWORD

O número de datagramas de saída descartados.

dwOutDiscards

Tipo: DWORD

O número de datagramas transmitidos descartados.

dwOutNoRoutes

Tipo: DWORD

O número de datagramas para os quais esse computador não tinha uma rota para o endereço IP de destino. Esses datagramas foram descartados.

dwReasmTimeout

Tipo: DWORD

A quantidade de tempo permitida para que todas as partes de um datagrama fragmentado cheguem. Se todas as partes não chegarem nesse momento, o datagrama será descartado.

dwReasmReqds

Tipo: DWORD

O número de datagramas que exigem o novo assembly.

dwReasmOks

Tipo: DWORD

O número de datagramas que foram remontados com êxito.

dwReasmFails

Tipo: DWORD

O número de datagramas que não podem ser remontados.

dwFragOks

Tipo: DWORD

O número de datagramas fragmentados com êxito.

dwFragFails

Tipo: DWORD

O número de datagramas que não foram fragmentados porque o cabeçalho IP não especifica nenhuma fragmentação. Esses datagramas são descartados.

dwFragCreates

Tipo: DWORD

O número de fragmentos criados.

dwNumIf

Tipo: DWORD

O número de interfaces.

dwNumAddr

Tipo: DWORD

O número de endereços IP associados a este computador.

dwNumRoutes

Tipo: DWORD

O número de rotas na tabela de roteamento de IP.

Comentários

A estrutura MIB_IPSTATS armazena informações por protocolo (IPv4 ou IPv6).

O membro dwForwarding especifica o estado de encaminhamento por protocolo para IPv4 ou IPv6, não o estado de encaminhamento de uma interface. O estado de encaminhamento de cada estado de interface é o estado que está em vigor para essa interface. O estado por protocolo retornado pelo GetIpStatistics ou pela função GetIpStatisticsEx não é o estado de encaminhamento em efeito. O membro dwForwarding existe para servir a duas finalidades:

  • Fornece um valor padrão para o estado de encaminhamento quando uma nova interface é criada sem nenhum estado de encaminhamento específico (nem desabilitado nem habilitado). Esse valor é herdado por estado de protocolo.
  • Fornece um valor definido por um administrador de domínio para habilitar ou desabilitar um estado de encaminhamento por protocolo. Os estados de encaminhamento de todas as interfaces que usam esse protocolo também estão habilitados ou desabilitados.
No Microsoft Software Development Kit do Windows (SDK do Windows) (SDK) lançado para Windows Vista e posteriores, a organização dos arquivos de cabeçalho foi alterada e a estrutura de MIB_IPSTATS é definida no arquivo de cabeçalho Ipmib.h não no arquivo de cabeçalho Iprtrmib.h. Observe que o arquivo de cabeçalho Ipmib.h é incluído automaticamente em Iprtrmib.h , que é incluído automaticamente no arquivo de cabeçalho Iphlpapi.h . Os arquivos de cabeçalho Ipmib.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 ipmib.h (inclua Iphlpapi.h)

Confira também

GetIpStatistics

GetIpStatisticsEx

SetIpStatistics

SetIpStatisticsEx