MultinetGetConnectionPerformance函数返回有关用于访问网络资源的连接的预期性能的信息。此函数仅可用于请求重定向到网络资源的本地设备的信息，或者对于当前连接的网络资源。
MultinetGetConnectionPerformance(
| LPNETRESOURCE 【lpNetResource】, | |
| LPNETCONNECTINFOSTRUCT 【lpNetConnectInfoStruct】, | |
| ); |
参数
【lpNetResource】
指定以下网络资源之一：
| 值 | 含义 |
| 【lpLocalName】 | 指向指定本地设备的缓冲区的指针，例如“F：”或“LPT1”，被重定向到要查询的网络资源。如果此参数为NULL或空字符串，则网络资源在【lpRemoteName】中指定。如果此标志指定本地设备，【lpRemoteName】将被忽略。 |
| 【LpRemoteName】 | 指定要查询的网络资源。该资源必须具有已建立的连接。例如，如果资源是文件服务器上的文件，则打开文件将确保连接。 |
| 【LpProvider】 | 通常设置为NULL，但是如果资源所在的网络已知，则可以可选地指定。如果【lpProvider】不为NULL，Windows将仅尝试命名网络。 |
【lpNetConnectInfoStruct】
指向NETCONNECTINFOSTRUCT结构。
返回值
如果函数成功，返回值为NO_ERROR。
如果函数失败，则返回值是以下错误值中的一个或多个。
| 值 | 含义 |
| ERROR_NOT_SUPPORTED | 网络资源不提供此信息。 |
| ERROR_NOT_CONNECTED | 【lpLocalName】不是重定向设备，或【lpRemoteName】不是当前连接的资源的名称。 |
| ERROR_NO_NET_OR_BAD_PATH | 无法处理操作，因为网络组件未启动或指定的资源名称未被识别。 |
| ERROR_BAD_DEVICE | 【lpLocalName】无效。 |
| ERROR_BAD_NET_NAME | 【lpRemoteName】未被任何网络识别。 |
| ERROR_INVALID_PARAMETER | 【lpNetConnectInfoStruct】不指向NETCONNECTINFOSTRUCT结构，其中cbStructure填充了结构大小，或者【lpLocalName】和【lpRemoteName】均未指定。 |
| ERROR_NO_NETWORK | 网络组件未运行。 |
| ERROR_EXTENDED_ERROR | 发生网络特定错误。要获取错误的描述，请调用WNetGetLastError. |
备注
MultinetGetConnectionPerformance函数返回的信息仅是估计。网络流量和路由可能会影响返回结果的准确性。
使用此函数的典型方式是在网络服务器上打开文件（这将确保与文件有连接），调用此函数，并使用结果来决定如何管理文件I / O 。例如，您可以决定是否将整个文件读入客户端上的临时文件，也可以直接访问服务器上的文件。
也可以看看
