WNetCancelConnection功能打破了现有的网络连接。
该函数是为兼容早期版本的Microsoft Windows而提供的。对于新的应用程序,请使用WNetCancelConnection2功能。
DWORD WNetCancelConnection(
LPTSTR 【lpName】, | //指向要断开的资源名称的指针 |
BOOL 【fForce】 | //无条件断开标志 |
); |
参数
【lpName】
指向一个以null结尾的字符串,指定重定向本地设备或要断开连接的远程网络资源的名称。当此参数指定重定向本地设备时,只有指定的设备重定向被破坏。如果参数指定了远程网络资源,则只有与没有设备的远程网络的连接断开。
【fForce】
指定即使连接上有打开的文件或作业,是否断开连接。如果此参数为FALSE,则如果存在打开的文件或作业,则该函数将失败。
返回值
如果函数成功,返回值为NO_ERROR。
如果函数失败,则返回值是错误代码。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
值 | 含义 |
ERROR_BAD_PROFILE | 用户配置文件的格式不正确。 |
ERROR_CANNOT_OPEN_PROFILE | 系统无法打开用户配置文件以处理持久连接。 |
ERROR_DEVICE_IN_USE | 该设备正在被活动进程使用,无法断开连接。 |
ERROR_EXTENDED_ERROR | 发生网络特定错误。要获取错误的描述,请使用WNetGetLastError功能。 |
ERROR_NOT_CONNECTED | 【lpName】参数指定的名称不是重定向设备,或者系统当前未连接到参数指定的设备。 |
ERROR_OPEN_FILES | 有打开的文件,【fForce】参数为FALSE。 |
该函数返回与Windows 3.1版兼容的错误代码。为了与Win32 API兼容,该函数还设置GetLastError返回的错误代码值。
也可以看看
WNetAddConnection, WNetAddConnection2, WNetCancelConnection2, WNetGetConnection, WNetGetLastError