通过

MultinetGetConnectionPerformanceA 函数（winnetwk.h）

  • 项目

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

语法

DWORD MultinetGetConnectionPerformanceA(
  [in]  LPNETRESOURCEA         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 参数不指向 NETCONNECTINFOSTRUCT 结构，cbStructure 成员填充正确的结构大小，则返回此错误。
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 [仅限桌面应用]
目标平台 窗户
标头 winnetwk.h
库 Mpr.lib
DLL Mpr.dll

另请参阅

NETCONNECTINFOSTRUCT

NETRESOURCE

Windows 网络（WNet）概述

Windows 网络函数