NetShareDelEx 函数 (lmshare.h)

从服务器的共享资源列表中删除共享名称,这会断开与该共享的所有连接。 此函数是 NetShareDel 函数的扩展版本,它允许调用方指定 SHARE_INFO_0SHARE_INFO_1SHARE_INFO_2SHARE_INFO_502SHARE_INFO_503 结构。

语法

NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE buf
);

参数

[in] servername

指向字符串的指针,该字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。 如果此参数为 NULL,则使用本地计算机。

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

[in] level

指定数据的信息级别。 此参数的取值可为下列值之一:

含义
0、1、2 或 502
指定有关共享资源的信息,包括资源的名称、类型和权限以及连接数。 buf 参数指向SHARE_INFO_0SHARE_INFO_1SHARE_INFO_2SHARE_INFO_502结构。
503
指定有关共享资源的信息,包括资源名称、类型和权限、连接数以及其他相关信息。 buf 参数指向SHARE_INFO_503结构。

[in] buf

指向指定数据的缓冲区的指针。 此数据的格式取决于 级别 参数的值。 有关详细信息,请参阅 网络管理功能缓冲区

返回值

如果函数成功,则返回值NERR_Success。

如果函数失败,则返回值可能是以下错误代码之一。

返回代码 说明
ERROR_INTERNAL_ERROR
发生内部错误。
ERROR_INVALID_LEVEL
级别 参数指定的值无效。
ERROR_NOT_SUPPORTED
不支持该请求。

注解

如果为 级别 参数指定了 503,则 buf 参数指向 SHARE_INFO_503 结构,并且该结构的 shi503_netnameshi503_servername 成员用于查找服务器上的共享资源;将忽略其他成员。 shi503_servername 成员中指定的远程服务器必须已使用 NetServerTransportAddEx 函数绑定到传输协议。 在对 NetServerTransportAddEx 的调用中,必须为 级别 参数指定 2 或 3,并且必须在传输协议的 SERVER_TRANSPORT_INFO_2 结构中指定 SVTI2_SCOPED_NAME 标志。

如果为 级别 参数指定了 0、1、2 或 502,则 buf 参数指向 SHARE_INFO_0SHARE_INFO_1SHARE_INFO_2SHARE_INFO_502 结构,并且使用该结构的 shi0_netnameshi1_netnameshi2_netnameshi502_netname 成员;将忽略其他成员。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 lmshare.h (包括 Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

另请参阅

NetServerTransportAddEx

NetShareAdd

NetShareDel

网络管理功能

网络管理概述

网络共享函数

SHARE_INFO_0

SHARE_INFO_1

SHARE_INFO_2

SHARE_INFO_502

SHARE_INFO_503