NetWkstaTransportDel 函数 (lmwksta.h)

  • 项目

[此函数已过时。 若要手动更改传输协议的默认设置，请使用“网络和拨号Connections”文件夹中的“本地连接属性”对话框。]

不支持。

NetWkstaTransportDel 函数将传输协议与重定向程序解除绑定。 (重定向程序是客户端计算机上的软件，用于向服务器计算机生成文件请求。)

语法

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportDel(
  [in] LMSTR servername,
  [in] LMSTR transportname,
  [in] DWORD ucond
);

参数

[in] servername

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

此字符串必须以 \开头。

[in] transportname

指向字符串的指针，该字符串指定要从重定向程序断开连接的传输协议的名称。

[in] ucond

指定从重定向程序断开传输协议时要使用的力级别。 此参数的取值可为下列值之一：

值 含义
USE_NOFORCE
 如果连接上存在打开的文件，则断开连接失败。
USE_FORCE
 如果连接上存在打开的文件，则断开连接失败。
USE_LOTS_OF_FORCE
 关闭任何打开的文件并删除连接。

返回值

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

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

返回代码 说明
ERROR_ACCESS_DENIED
 用户无权访问请求的信息。
ERROR_INVALID_PARAMETER
 其中一个函数参数无效。
NERR_UseNotFound
 网络连接不存在。

注解

只有管理员本地组的成员才能成功执行 NetWkstaTransportDel 函数。

要求

要求 值
目标平台 Windows
标头 lmwksta.h (包括 Lm.h、Lmwksta.h)
Library Netapi32.lib
DLL Netapi32.dll