NetUseAdd 函数 (lmuse.h)

项目
02/28/2024

NetUseAdd 函数在本地计算机和远程服务器之间建立连接。可以指定要连接的本地驱动器号或打印机设备。如果未指定本地驱动器号或打印机设备，函数会向服务器对客户端进行身份验证，以便将来建立连接。

语法

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

参数

[in] servername

要执行此函数的计算机的 UNC 名称。如果此参数为 NULL，则使用本地计算机。如果指定的 UncServerName 参数是远程计算机，则远程计算机必须支持使用旧式远程访问协议机制的远程 RPC 调用。

如果定义了 _WIN32_WINNT 或 FORCE_UNICODE ，则此字符串为 Unicode。

[in] LevelFlags

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

值	含义
1	指定有关本地设备和共享资源之间的连接的信息。信息包括连接状态和类型。 Buf 参数是指向USE_INFO_1结构的指针。
2	指定有关本地设备和共享资源之间的连接的信息。信息包括连接状态和类型，以及用户名和域名。 Buf 参数是指向USE_INFO_2结构的指针。

[in] buf

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

[out] parm_err

指向一个值的指针，该值在返回ERROR_INVALID_PARAMETER错误时接收错误中信息结构第一个成员的索引。如果此参数为 NULL，则错误时不会返回索引。有关更多信息，请参见下面的“备注”部分。

返回值

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

如果函数失败，则返回值为系统错误代码。有关错误代码的列表，请参阅系统错误代码。

注解

还可以使用 WNetAddConnection2 和 WNetAddConnection3 函数将本地设备重定向到网络资源。

调用 NetUseAdd 函数不需要特殊的组成员身份。此函数不能在远程服务器上执行，除非是下层兼容性的情况。

此函数仅适用于服务器消息块 (LAN Manager 工作站) 客户端。 NetUseAdd 函数不支持分布式文件系统 (DFS) 共享。若要使用其他网络提供程序 (WebDAV 或 DFS 共享添加共享（例如) ），请使用 WNetAddConnection2 或 WNetAddConnection3 函数。

如果 NetUseAdd 函数返回ERROR_INVALID_PARAMETER，则可以使用 ParmError 参数来指示信息结构的第一个成员无效。 (信息结构以 USE_INFO_ 开头，其格式由 Level 参数指定。) 下表列出了可在 ParmError 参数中返回的值以及出错的相应结构成员。 (前缀 ui*_ 指示成员可以以多个前缀开头，例如，ui1_或ui2_.)

常数	值	成员
USE_LOCAL_PARMNUM	1	ui*_local
USE_REMOTE_PARMNUM	2	ui*_remote
USE_PASSWORD_PARMNUM	3	ui*_password
USE_ASGTYPE_PARMNUM	4	ui*_asg_type
USE_USERNAME_PARMNUM	5	ui*_username
USE_DOMAINNAME_PARMNUM	6	ui*_domainname

要求

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