MultinetGetConnectionPerformance (winnetwk.h)

项目
08/27/2023

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 参数未指向在其中用适当结构大小填充 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

另请参阅

通过

MultinetGetConnectionPerformance (winnetwk.h)

语法

参数

返回值

注解

要求

另请参阅

反馈

反馈

其他资源