通过

NetWkstaTransportAdd 函数 (lmwksta.h)

  • 项目

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

不支持。

NetWkstaTransportAdd 函数将 (绑定或) 重定向程序连接到传输。 重定向程序是客户端计算机上的软件，用于生成对服务器计算机的文件请求。

语法

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

parameters

[in] servername

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

此字符串必须以 \开头。

[in] level

指定数据的信息级别。 此参数可以是以下值。

值 含义
0
 指定工作站传输协议信息。 buf 参数指向WKSTA_TRANSPORT_INFO_0结构。

[in] buf

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

[out] parm_err

指向一个值的指针，该值接收导致ERROR_INVALID_PARAMETER错误的第一个参数的索引。 如果此参数为 NULL，则错误时不会返回索引。

返回值

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

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

返回代码 说明
ERROR_ACCESS_DENIED
 用户无权访问请求的信息。
ERROR_INVALID_LEVEL
 指示可用的数据结构信息的级别参数无效。
ERROR_INVALID_PARAMETER
 其中一个函数参数无效。

注解

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

如果 NetWkstaTransportAdd 函数返回ERROR_INVALID_PARAMETER，则可以使用 parm_err 参数来指示 WKSTA_TRANSPORT_INFO_0 结构的成员无效。 下表列出了可在 parm_err 参数中返回的值，以及出错的相应结构成员。

值 成员
TRANSPORT_QUALITYOFSERVICE_PARMNUM wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM wkti0_transport_name

要求

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