NetServerTransportDel 函数 (lmserver.h)

NetServerTransportDel 函数 (或断开) 传输协议与服务器的绑定。 实际上,服务器不能再使用指定的传输协议 ((例如 TCP 或 XNS) )与客户端通信。

语法

NET_API_STATUS NET_API_FUNCTION NetServerTransportDel(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

parameters

[in] servername

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

[in] level

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

含义
0
指定有关传输协议的信息,包括网络上的名称、地址和位置。 bufptr 参数指向SERVER_TRANSPORT_INFO_0结构。
1
指定有关传输协议的信息,包括名称、地址、网络位置和域。 bufptr 参数指向SERVER_TRANSPORT_INFO_1结构。

[in] bufptr

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

返回值

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

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

返回代码 说明
ERROR_ACCESS_DENIED
用户无权访问请求的信息。
ERROR_INVALID_LEVEL
级别 参数指定的值无效。
ERROR_INVALID_PARAMETER
指定的参数无效。
ERROR_NOT_ENOUGH_MEMORY
可用内存不足。
NERR_NetNameNotFound
共享名称不存在。

注解

只有管理员或服务器操作员本地组的成员才能成功执行 NetServerTransportDel 函数。

要求

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

另请参阅

NetServerTransportAdd

网络管理功能

网络管理概述

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

服务器和工作站传输函数