WNetConnectionDialog1A 函数（winnetwk.h）

项目
11/20/2024

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

语法

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

参数

[in, out] lpConnDlgStruct

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

返回值

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

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

返回代码	描述
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 [仅限桌面应用]
目标平台	窗户
标头	winnetwk.h
库	Mpr.lib
DLL	Mpr.dll