通过

MultinetGetConnectionPerformanceW 函数 (winnetwk.h)

  • 项目

MultinetGetConnectionPerformance 函数返回有关用于访问网络资源的连接的预期性能的信息。

语法

DWORD MultinetGetConnectionPerformanceW(
  [in]  LPNETRESOURCEW         lpNetResource,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);

参数

[in] lpNetResource

指向指定网络资源的 NETRESOURCE 结构的指针。 以下成员在此上下文中具有特定含义。

成员 含义
lpLocalName
 指向缓冲区的指针，该缓冲区指定重定向到要查询的网络资源的本地设备，例如“F：”或“LPT1”。

如果此成员为 NULL 或空字符串，则网络资源在 lpRemoteName 成员中指定。 如果此标志指定本地设备，则忽略 lpRemoteName 。
lpRemoteName
 指向要查询的网络资源的指针。 资源当前必须建立连接。 例如，如果资源是文件服务器上的文件，则打开该文件将确保连接。
lpProvider
 通常设置为 NULL，但如果资源所在的网络已知，则可以是指向资源的所有者 (提供程序) 的指针。

如果 lpProvider 成员不是 NULL，则系统会尝试仅返回有关命名网络的信息。

[out] lpNetConnectInfoStruct

指向接收数据的 NETCONNECTINFOSTRUCT 结构的指针。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值是 系统错误代码，例如以下值之一。

返回代码 说明
ERROR_NOT_SUPPORTED
 网络资源不提供此信息。
ERROR_NOT_CONNECTED
 lpNetResource 参数指向的 NETRESOURCE 结构的 lpLocalName 成员未指定重定向的设备，或者 lpRemoteName 成员未指定当前连接的资源的名称。
ERROR_NO_NET_OR_BAD_PATH
 由于网络组件未启动，或者无法识别指定的资源名称，因此无法完成该操作。
ERROR_BAD_DEVICE
 lpLocalName 成员指定的本地设备无效。
ERROR_BAD_NET_NAME
 找不到网络名称。 如果 lpNetResource 参数指向的 NETRESOURCE 结构的 lpLocalName 成员为 NULL，并且 lpNetResource 所指向的 NETRESOURCE 结构的 lpRemoteName 成员也为 NULL 或无法被任何网络识别，则返回此错误。
ERROR_INVALID_ADDRESS
 尝试访问无效地址。 如果 lpNetResource 或 lpNetConnectInfoStruct 参数为 NULL，则返回此错误。
ERROR_INVALID_PARAMETER
 传递了错误的参数。 如果 lpNetConnectInfoStruct 参数未指向其中 cbStructure 成员填充适当结构大小的 NETCONNECTINFOSTRUCT 结构，则返回此错误。
ERROR_NO_NETWORK
 网络不可用。
ERROR_EXTENDED_ERROR
 发生特定于网络的错误。 若要获取错误的说明，请调用 WNetGetLastError。

注解

MultinetGetConnectionPerformance 函数返回 NETCONNECTINFOSTRUCT 结构中的信息。

MultinetGetConnectionPerformance 函数返回的信息只是估计值。 网络流量和路由可能会影响返回的结果的准确性。

请注意， MultinetGetConnectionPerformance 函数只能用于请求重定向到网络资源的本地设备的信息，或者请求当前连接到的网络资源的信息。

如果在 lpNetResource 参数指向的 NETRESOURCE 结构的 lpRemoteName 成员中指定了 UNC 路径，则 lpRemoteName 成员必须是目录名称，而不是文件名。

使用此函数的典型方法是在网络服务器上打开文件， (这将确保与文件) 建立连接，调用此函数，并使用结果来决定如何管理文件 I/O。 例如，可以决定是将整个文件读取到客户端上的临时文件中，还是直接访问服务器上的文件。

注意

winnetwk.h 标头将 MultinetGetConnectionPerformance 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winnetwk.h
Library Mpr.lib
DLL Mpr.dll

另请参阅

NETCONNECTINFOSTRUCT

NETRESOURCE

Windows 网络 (WNet) 概述

Windows 网络函数