NetUseDel 函数 (lmuse.h)
NetUseDel 函数结束与共享资源的连接。
还可以使用 WNetCancelConnection2 函数终止网络连接。
语法
NET_API_STATUS NET_API_FUNCTION NetUseDel(
[in] LMSTR UncServerName,
[in] LMSTR UseName,
[in] DWORD ForceLevelFlags
);
parameters
[in] UncServerName
要执行此函数的计算机的 UNC 名称。 如果 is 参数为 NULL,则使用本地计算机。
如果指定的 UncServerName 参数是远程计算机,则远程计算机必须支持使用旧版远程访问协议机制的远程 RPC 调用。
如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ,则此字符串为 Unicode。
[in] UseName
指向指定要删除的连接路径的字符串的指针。
如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ,则此字符串为 Unicode。
[in] ForceLevelFlags
删除连接时要使用的力级别。
此参数可以是 lmuseflg.h 头文件中定义的以下值之一。
值 | 含义 |
---|---|
|
如果连接上存在打开的文件,则断开连接失败。 |
|
如果连接上存在打开的文件,则不要使断开连接失败。 |
|
关闭所有打开的文件并删除连接。 |
返回值
如果函数成功,则返回值NERR_Success。
如果函数失败,则返回值为系统错误代码。 有关错误代码的列表,请参阅 系统错误代码。
注解
NetUseDel 函数仅适用于服务器消息块 (LAN Manager 工作站) 客户端。 NetUseDel 函数不支持分布式文件系统 (DFS) 共享或其他网络文件系统。 若要终止使用其他网络提供程序 (WebDAV 或 DFS 共享(例如) )与共享的连接,请使用 WNetCancelConnection2 函数。
调用 NetUseDel 函数不需要特殊组成员身份。 此函数不能在远程服务器上执行,除非是下层兼容性的情况。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lmuse.h (包括 Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |