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_WINNTFORCE_UNICODE ,则此字符串为 Unicode。

[in] UseName

指向指定要删除的连接路径的字符串的指针。

如果定义了 _WIN32_WINNTFORCE_UNICODE ,则此字符串为 Unicode。

[in] ForceLevelFlags

删除连接时要使用的力级别。

此参数可以是 lmuseflg.h 头文件中定义的以下值之一。

含义
USE_NOFORCE
如果连接上存在打开的文件,则断开连接失败。
USE_FORCE
如果连接上存在打开的文件,则不要使断开连接失败。
USE_LOTS_OF_FORCE
关闭所有打开的文件并删除连接。

返回值

如果函数成功,则返回值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

另请参阅

NetUseAdd

网络管理功能

网络管理概述

使用函数

WNetCancelConnection2