WNetGetNetworkInformationA 函数 (winnetwk.h)

项目
08/27/2023

WNetGetNetworkInformation 函数返回有关其名称由以前的网络枚举返回的特定网络提供程序的扩展信息。

语法

DWORD WNetGetNetworkInformationA(
  [in]  LPCSTR          lpProvider,
  [out] LPNETINFOSTRUCT lpNetInfoStruct
);

参数

[in] lpProvider

指向常量以 null 结尾的字符串的指针，该字符串包含需要其信息的网络提供程序的名称。

[out] lpNetInfoStruct

指向 NETINFOSTRUCT 结构的指针。结构描述网络的特征。

返回值

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

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

返回代码	说明
ERROR_BAD_PROVIDER	lpProvider 参数与任何正在运行的网络提供程序都不匹配。
ERROR_BAD_VALUE	NETINFOSTRUCT 结构的 cbStructure 成员不包含有效的结构大小。

注解

注意

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

要求


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