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