WNetConnectionDialog功能启动一个常规浏览对话框,用于连接到网络资源。
DWORD WNetConnectionDialog(
HWND 【HWND】, | //窗口拥有对话框的句柄 |
DWORD 【dwType】 | //允许连接的资源类型 |
); |
参数
【HWND】
标识所属窗口。
【dwType】
指定允许连接的资源类型。该参数可以是以下值:
值 | 含义 |
RESOURCETYPE_DISK | 连接到磁盘资源。 |
返回值
如果函数成功,返回值为NO_ERROR。如果用户取消对话框,则为0xFFFFFFFF。
如果函数失败,则返回值是错误代码。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
值 | 含义 |
ERROR_EXTENDED_ERROR | 发生网络特定错误。要获取错误的描述,请使用WNetGetLastError功能。 |
ERROR_INVALID_PASSWORD | 指定的密码无效。 |
ERROR_NO_NETWORK | 没有网络。 |
ERROR_NOT_ENOUGH_MEMORY | 没有足够的内存启动对话框。 |
该函数返回与Windows 3.1版兼容的错误代码。为了与Win32 API的相容性,该函数还设置由GetLastError函数返回的错误码值。
备注
如果用户在对话框中选择“确定”,则当WNetConnectionDialog返回时,所请求的网络连接将被执行。
如果该函数尝试进行连接,并且提供程序返回消息ERROR_INVALID_PASSWORD,Windows将提示用户输入密码,并在另一次尝试中使用新密码进行连接。
也可以看看
WNetAddConnection2, WNetCancelConnection2, WNetDisconnectDialog, WNetGetLastError