WNetConnectionDialog1A 函数 (winnetwk.h)

项目
08/27/2023

WNetConnectionDialog1 函数显示用于连接到网络资源的常规浏览对话框。函数需要 CONNECTDLGSTRUCT 来建立对话框参数。

语法

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

参数

[in, out] lpConnDlgStruct

指向 CONNECTDLGSTRUCT 结构的指针。结构建立浏览对话框参数。

返回值

如果用户取消对话框，函数将返回 –1。如果该函数成功，则返回NO_ERROR。此外，如果调用成功，CONNECTDLGSTRUCT 结构的 dwDevNum 成员将包含已连接设备的编号。

通常，仅当用户无法进入对话会话时，此对话才会返回错误。这是因为对话会话后发生的错误会直接报告给用户。如果函数失败，则返回值为系统错误代码，例如以下值之一。

返回代码	说明
ERROR_INVALID_PARAMETER	同时设置了CONNDLG_RO_PATH和CONNDLG_USE_MRU对话框选项。 (对话框选项由 CONNECTDLGSTRUCT 结构的 dwFlags 成员指定。) 或同时设置了CONNDLG_PERSIST和CONNDLG_NOT_PERSIST对话框选项。或设置CONNDLG_RO_PATH对话框选项，并且 NETRESOURCE 结构的 lpRemoteName 成员不指向远程网络。 (CONNECTDLGSTRUCT 结构指向 NETRESOURCE 结构。)
ERROR_BAD_DEV_TYPE	NETRESOURCE 结构的 dwType 成员未设置为 RESOURCETYPE_DISK。
ERROR_BUSY	网络提供商正忙于 (可能正在初始化) 。调用方应重试。
ERROR_NO_NETWORK	网络不可用。
ERROR_NOT_ENOUGH_MEMORY	内存不足，无法显示对话框。
ERROR_EXTENDED_ERROR	发生特定于网络的错误。调用 WNetGetLastError 以获取错误说明。

注解

注意

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

要求


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