NETCONNECTINFOSTRUCT 结构 (winnetwk.h)

  • 项目

NETCONNECTINFOSTRUCT 结构包含有关网络性能的信息。 它由 NPGetConnectionPerformance 函数使用。

语法

typedef struct _NETCONNECTINFOSTRUCT {
  DWORD cbStructure;
  DWORD dwFlags;
  DWORD dwSpeed;
  DWORD dwDelay;
  DWORD dwOptDataSize;
} NETCONNECTINFOSTRUCT, *LPNETCONNECTINFOSTRUCT;

成员

cbStructure

NETCONNECTINFOSTRUCT 结构的大小（以字节为单位）。 这由调用方填充，以指示传入的结构的大小。 网络提供商应保留此字段不变，并可以假定结构足够大，足以包含所有字段，包括 dwOptDataSize。

dwFlags

这是一个位掩码，可能具有以下一个或多个标志。

值 含义
WNCON_FORNETCARD
 如果设置，则返回的信息用于用于连接的网卡的性能。 如果有关实际连接的信息不可用，则返回此信息。

如果未设置，则返回的信息适用于与资源的当前连接，并考虑任何路由降级。
WNCON_NOTROUTED
 如果设置连接，则不会将连接视为正在路由。 换句话说，在估算性能时不会考虑路由。 这意味着实际性能可能远远低于返回的信息。

如果未设置，则连接可能通过限制性能的路由器。
WNCON_SLOWLINK
 如果设置，则已知连接在某个时间点通过通常较慢的介质 (例如，使用正常质量电话线路的调制解调器) 。

在 dwSpeed 中返回值的提供程序不必设置此位。
WNCON_DYNAMIC
 如果设置，则返回的某些信息将动态重新计算。 如果是这种情况，则重新发出对连接的请求可能会返回不同、更最新的信息。

dwSpeed

媒体到网络资源的速度（单位为 100bps）。 例如，1，200 波特的点到点链接返回 12。

dwDelay

网络在发送信息时引入的延迟（以毫秒为单位）。 换句话说，网络开始发送数据与接收数据之间的时间。 这是除包含在 dwSpeed 计算中的任何延迟之外，因此对于访问大多数资源，返回的值将为零。

dwOptDataSize

有关数据大小（以字节为单位）的建议，当应用程序向网络资源发出单个请求时，该大小通过网络发送的最有效。 例如，对于磁盘网络资源，在写入数据块时，此值可能是 2048 或 512。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 winnetwk.h