WNetConnectionDialog 函数 (winnetwk.h)

WNetConnectionDialog 函数启动常规浏览对话框，用于连接到网络资源。函数需要对话框的所有者窗口的句柄。

语法

DWORD WNetConnectionDialog(
  [in] HWND  hwnd,
  [in] DWORD dwType
);

[in] hwnd

对话框的所有者窗口的句柄。

[in] dwType

允许连接到的资源类型。此参数可以是以下值。

值	含义
RESOURCETYPE_DISK	与磁盘资源的连接。

如果函数成功，则返回值NO_ERROR。如果用户取消对话框，函数将返回 –1。

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

返回代码	说明
ERROR_EXTENDED_ERROR	发生特定于网络的错误。若要获取错误的说明，请调用 WNetGetLastError 函数。
ERROR_INVALID_PASSWORD	指定的密码无效。
ERROR_NO_NETWORK	网络不可用。
ERROR_NOT_ENOUGH_MEMORY	内存不足，无法启动对话框。

如果用户在对话框中单击 “确定” ，则当 WNetConnectionDialog 函数返回时，将建立请求的网络连接。

如果函数尝试建立连接，而网络提供程序ERROR_INVALID_PASSWORD返回消息，系统会提示用户输入密码。系统在另一次尝试建立连接时使用新密码。


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