NPGetConnectionPerformance 函数 (npapi.h)
返回有关用于访问网络资源的连接的预期性能的信息。 请求只能针对当前连接的网络资源。
语法
DWORD NPGetConnectionPerformance(
[in] LPCWSTR lpRemoteName,
[out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);
parameters
[in] lpRemoteName
指向已连接资源的本地名称或远程名称的指针。
[out] lpNetConnectInfo
指向 NETCONNECTINFOSTRUCT 结构的指针,如果提供程序与网络资源建立连接,则由网络提供程序填充该结构。 在 MPR 将请求传递给网络提供程序之前,此结构的所有其他字段( cbStructure 字段除外)都用零填充。 因此,提供程序必须仅写入具有可用信息的字段。 此外,对于速率值,值为 1 表示性能优于可以用单位表示的性能。
返回的信息可能是估计信息。 如果网络无法获取有关网络上的资源的信息,它可以返回有关网络适配器及其关联性能的信息,然后相应地设置 dwFlags 字段。
返回值
如果该函数成功,则它应返回WN_SUCCESS。 否则,它应返回错误代码,可能是以下代码之一。
返回代码 | 说明 |
---|---|
|
lpRemoteName 不是连接的网络资源。 |
|
网络不存在。 |
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | npapi.h |