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