NetShareDelEx 函数 (lmshare.h)
从服务器的共享资源列表中删除共享名称,这会断开与该共享的所有连接。 此函数是 NetShareDel 函数的扩展版本,它允许调用方指定 SHARE_INFO_0、 SHARE_INFO_1、 SHARE_INFO_2、 SHARE_INFO_502或 SHARE_INFO_503 结构。
语法
NET_API_STATUS NET_API_FUNCTION NetShareDelEx(
[in] LMSTR servername,
[in] DWORD level,
[in] LPBYTE buf
);
参数
[in] servername
指向字符串的指针,该字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。 如果此参数为 NULL,则使用本地计算机。
如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ,则此字符串为 Unicode。
[in] level
指定数据的信息级别。 此参数的取值可为下列值之一:
值 | 含义 |
---|---|
|
指定有关共享资源的信息,包括资源的名称、类型和权限以及连接数。 buf 参数指向SHARE_INFO_0、SHARE_INFO_1、SHARE_INFO_2或SHARE_INFO_502结构。 |
|
指定有关共享资源的信息,包括资源名称、类型和权限、连接数以及其他相关信息。 buf 参数指向SHARE_INFO_503结构。 |
[in] buf
指向指定数据的缓冲区的指针。 此数据的格式取决于 级别 参数的值。 有关详细信息,请参阅 网络管理功能缓冲区。
返回值
如果函数成功,则返回值NERR_Success。
如果函数失败,则返回值可能是以下错误代码之一。
返回代码 | 说明 |
---|---|
|
发生内部错误。 |
|
为 级别 参数指定的值无效。 |
|
不支持该请求。 |
注解
如果为 级别 参数指定了 503,则 buf 参数指向 SHARE_INFO_503 结构,并且该结构的 shi503_netname 和 shi503_servername 成员用于查找服务器上的共享资源;将忽略其他成员。 shi503_servername 成员中指定的远程服务器必须已使用 NetServerTransportAddEx 函数绑定到传输协议。 在对 NetServerTransportAddEx 的调用中,必须为 级别 参数指定 2 或 3,并且必须在传输协议的 SERVER_TRANSPORT_INFO_2 结构中指定 SVTI2_SCOPED_NAME 标志。
如果为 级别 参数指定了 0、1、2 或 502,则 buf 参数指向 SHARE_INFO_0、 SHARE_INFO_1、 SHARE_INFO_2或 SHARE_INFO_502 结构,并且使用该结构的 shi0_netname、 shi1_netname、 shi2_netname或 shi502_netname 成员;将忽略其他成员。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | lmshare.h (包括 Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |