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_FORWARDING 是 Ipmib.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.h 和 Iprtrmib.h 头文件。

要求

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

另请参阅

GetIpStatistics

GetIpStatisticsEx

SetIpStatistics

SetIpStatisticsEx