WNetCancelConnection2

【勇芳软件工作室】汉化HomePreviousNext

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