ipmib.h) (MIB_IPSTATS_LH 结构

MIB_IPSTATS结构存储有关在特定计算机上运行的 IP 协议的信息。

语法

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;

成员

dwForwarding

类型:DWORD

指定是否为 IPv4 或 IPv6) (协议启用或禁用 IP 转发。

在 Windows Vista 及更高版本中,此成员定义为包含 DWORD dwForwarding 成员和 MIB_IPSTATS_FORWARDING转发 成员的联合,其中 MIB_IPSTATS_FORWARDINGIpmib.h 头文件中定义的枚举。

注意 此成员适用于每个协议 (IPv4 或 IPv6) 的整个系统,并且不会针对 IP 转发返回每个接口的配置。
 
含义
MIB_IP_FORWARDING
1
IP 转发已启用。
MIB_IP_NOT_FORWARDING
2
未启用 IP 转发。
MIB_USE_CURRENT_FORWARDING
0xffff
使用当前 IP 转发设置。 仅当使用 SetIpStatistics 和 SetIpStatisticsEx 函数设置转发和生存时间 (TTL) 选项时,此值才适用。

Forwarding

dwDefaultTTL

类型:DWORD

对于源自特定计算机上的数据报,默认的初始生存时间 (TTL) 。

当使用 SetIpStatistics 和 SetIpStatisticsEx 函数设置转发和生存时间 (TTL) 选项时,可以将此成员设置为 MIB_USE_CURRENT_TTL 以使用当前默认 TTL 值。

dwInReceives

类型:DWORD

接收的数据报数。

dwInHdrErrors

类型:DWORD

收到的具有标头错误的数据报数。

dwInAddrErrors

类型:DWORD

收到的具有地址错误的数据报数。

dwForwDatagrams

类型:DWORD

转发的数据报数。

dwInUnknownProtos

类型:DWORD

收到的具有未知协议的数据报数。

dwInDiscards

类型:DWORD

已丢弃的接收数据报数。

dwInDelivers

类型:DWORD

已传递的接收数据报数。

dwOutRequests

类型:DWORD

请求 IP 传输的传出数据报数。 此数字不包括转发的数据报。

dwRoutingDiscards

类型:DWORD

丢弃的传出数据报数。

dwOutDiscards

类型:DWORD

丢弃的传输数据报数。

dwOutNoRoutes

类型:DWORD

此计算机没有指向目标 IP 地址的路由的数据报数。 这些数据报被丢弃。

dwReasmTimeout

类型:DWORD

允许碎片数据报的所有部分到达的时间量。 如果所有部分都未在此时间内到达,则会丢弃数据报。

dwReasmReqds

类型:DWORD

需要重新汇编的数据报数。

dwReasmOks

类型:DWORD

已成功重新组合的数据报数。

dwReasmFails

类型:DWORD

无法重新组合的数据报数。

dwFragOks

类型:DWORD

成功分段的数据报数。

dwFragFails

类型:DWORD

由于 IP 标头未指定碎片而未分段的数据报数。 这些数据报将被丢弃。

dwFragCreates

类型:DWORD

创建的片段数。

dwNumIf

类型:DWORD

接口数。

dwNumAddr

类型:DWORD

与此计算机关联的 IP 地址数。

dwNumRoutes

类型:DWORD

IP 路由表中的路由数。

注解

MIB_IPSTATS结构 (IPv4 或 IPv6) 存储每个协议的信息。

dwForwarding 成员指定 IPv4 或 IPv6 的每个协议转发状态,而不是接口的转发状态。 每个接口状态的转发状态是该接口受影响的状态。 GetIpStatistics 或 GetIpStatisticsEx 函数返回的每协议状态不是受影响的转发状态。 dwForwarding 成员存在用于两个目的:

  • 在创建新接口时提供转发状态的默认值,该接口没有特定的转发状态, () 既未禁用也不启用。 此值按协议状态继承。
  • 提供由域管理员设置的值,以启用或禁用按协议转发状态。 还启用或禁用使用该协议的所有接口的转发状态。
在为 Windows Vista 及更高版本发布的 Microsoft Windows 软件开发工具包 (Windows SDK) (SDK) 上,头文件的组织已更改,MIB_IPSTATS结构在 Ipmib.h 头文件中定义,而不是在 Iprtrmib.h 头文件中定义。 请注意,Ipmib.h 头文件会自动包含在 Iphlpapi.h 头文件中的 Iprtrmib.h 中。 不应直接使用 Ipmib.hIprtrmib.h 头文件。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 ipmib.h (包括 Iphlpapi.h)

另请参阅

GetIpStatistics

GetIpStatisticsEx

SetIpStatistics

SetIpStatisticsEx