WNetCancelConnection2功能打破了现有的网络连接。它也可以用于删除当前未连接的记忆网络连接。此函数取代WNetCancelConnection.
DWORD WNetCancelConnection2(
LPTSTR 【lpName】, | //指向要断开的资源名称的指针 |
DWORD 【dwFlags中】, | //连接类型标志 |
BOOL 【fForce】 | //无条件断开标志 |
); |
参数
【lpName】
指向一个以null结尾的字符串,指定重定向本地设备或要断开连接的远程网络资源的名称。如果此参数指定重定向的本地资源,则只会指定重定向;否则,到远程网络资源的所有连接都将被破坏。
【dwFlags中】
指定连接类型的位掩码。定义了以下值:
值 | 含义 |
0 | 没有更新关于连接的存储信息。如果连接在注册表中被标记为持久性,则Windows将在下次登录时仍恢复连接。如果连接未被标记为持久性,则该函数将忽略CONNECT_UPDATE_PROFILE标志的设置。 |
CONNECT_UPDATE_PROFILE | 使用不再是持久连接的信息更新用户配置文件。在后续登录操作期间,Windows将无法恢复此连接。使用远程名称断开资源对持久连接没有影响。 |
【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。 |
也可以看看
WNetAddConnection, WNetAddConnection2, WNetAddConnection3, WNetCancelConnection, WNetGetConnection, WNetGetLastError