NPGetConnectionPerformance 函数 (npapi.h)

  • 项目

返回有关用于访问网络资源的连接的预期性能的信息。 请求只能针对当前连接的网络资源。

语法

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

parameters

[in] lpRemoteName

指向已连接资源的本地名称或远程名称的指针。

[out] lpNetConnectInfo

指向 NETCONNECTINFOSTRUCT 结构的指针，如果提供程序与网络资源建立连接，则由网络提供程序填充该结构。 在 MPR 将请求传递给网络提供程序之前，此结构的所有其他字段（ cbStructure 字段除外）都用零填充。 因此，提供程序必须仅写入具有可用信息的字段。 此外，对于速率值，值为 1 表示性能优于可以用单位表示的性能。

返回的信息可能是估计信息。 如果网络无法获取有关网络上的资源的信息，它可以返回有关网络适配器及其关联性能的信息，然后相应地设置 dwFlags 字段。

返回值

如果该函数成功，则它应返回WN_SUCCESS。 否则，它应返回错误代码，可能是以下代码之一。

返回代码 说明
WN_NOT_CONNECTED
 lpRemoteName 不是连接的网络资源。
WN_NO_NETWORK
 网络不存在。

要求

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