WNetUseConnectionA 函数 （winnetwk.h）
WNetUseConnection 函数与网络资源建立连接。 该函数可以将本地设备重定向到网络资源。
WNetUseConnection 函数类似于 WNetAddConnection3 函数。 主要区别在于，WNetUseConnection 可以自动选择未使用的本地设备以重定向到网络资源。
语法
DWORD WNetUseConnectionA(
[in] HWND hwndOwner,
[in] LPNETRESOURCEA lpNetResource,
[in] LPCSTR lpPassword,
[in] LPCSTR lpUserId,
[in] DWORD dwFlags,
[out] LPSTR lpAccessName,
[in, out] LPDWORD lpBufferSize,
[out] LPDWORD lpResult
);
参数
[in] hwndOwner
处理网络资源的提供程序可以用作对话框的所有者窗口的句柄。 如果在 dwFlags 参数中设置CONNECT_INTERACTIVE值，请使用此参数。
[in] lpNetResource
指向 NETRESOURCE 结构的指针，该结构指定建议的连接的详细信息。 该结构包含有关网络资源、本地设备和网络资源提供程序的信息。
必须指定 NETRESOURCE 结构的以下成员。
WNetUseConnection 函数忽略 NETRESOURCE 结构的其他成员。 有关详细信息，请参阅 dwFlags 参数的说明。
[in] lpPassword
指向常量 null终止字符串的指针，该字符串指定要在建立网络连接时使用的密码。
如果 lpPasswordNULL，则该函数将使用与 lpUserID指定的用户关联的当前默认密码。
如果 lpPassword 指向空字符串，则函数不使用密码。
如果连接因密码无效而失败，并且CONNECT_INTERACTIVE值是在 dwFlags 参数
[in] lpUserId
指向常量 null-terminated 字符串的指针，该字符串指定用于建立连接的用户名。
如果 lpUserIDNULL，则该函数使用默认用户名。 （进程的用户上下文提供默认用户名。
当用户想要连接到为其分配了用户名或帐户以外的用户名或帐户的网络资源时，将指定 lpUserID 参数。
用户名字符串表示 安全上下文。 它可能特定于网络提供商。
[in] dwFlags
描述连接的位标志集。 此参数可以是以下值的任意组合。
| 价值 | 意义 |
|---|---|
|
如果设置了此标志，操作系统可能会与用户交互，以便进行身份验证。 |
|
此标志指示系统不要对用户名或密码使用任何默认设置，而无需为用户提供提供替代方法的机会。 除非还设置了CONNECT_INTERACTIVE，否则将忽略此标志。 |
|
此标志在建立连接时强制重定向本地设备。
如果 NETRESOURCElpLocalName 成员指定要重定向的本地设备，则此标志不起作用，因为操作系统仍尝试重定向指定的设备。 当操作系统自动选择本地设备时，dwType 成员不得等于RESOURCETYPE_ANY。 如果未设置此标志，则仅当网络需要重定向本地设备时，才会自动选择本地设备进行重定向。 Windows XP：当系统自动分配网络驱动器号时，以 Z：、Y：和以 C： 结尾分配字母。 这可以减少每登录驱动器号（如网络驱动器号）与全局驱动器号（如磁盘驱动器）之间的冲突。 请注意，以前的版本分配的驱动器号以 C： 开头，以 Z：结尾。 |
|
此标志指示操作系统存储网络资源连接。
如果设置了此位标志，则操作系统会在用户登录时自动尝试还原连接。 系统仅记住重定向本地设备的成功连接。 它不记得连接失败或无设备连接。 （lpLocalNameNULL 或指向空字符串时发生无设备连接。 如果此位标志明确，则操作系统不会在登录时自动还原连接。 |
|
如果设置了此标志，操作系统会提示用户使用命令行而不是图形用户界面（GUI）进行身份验证。 除非还设置了CONNECT_INTERACTIVE，否则将忽略此标志。
Windows 2000/NT 和 Windows Me/98/95：不支持 此值。 |
|
如果设置了此标志，并且操作系统会提示输入凭据，则应由凭据管理器保存凭据。 如果为调用方登录会话禁用凭据管理器，或者网络提供程序不支持保存凭据，则忽略此标志。 除非设置了CONNECT_COMMANDLINE标志，否则也会忽略此标志。
Windows 2000/NT 和 Windows Me/98/95：不支持 此值。 |
[out] lpAccessName
指向在连接上接收系统请求的缓冲区的指针。 此参数可以 NULL。
如果指定此参数，并且 NETRESOURCE 结构的 lpLocalName 成员指定本地设备，则此缓冲区接收本地设备名称。 如果 lpLocalName 未指定设备，并且网络需要本地设备重定向，或者设置了CONNECT_REDIRECT值，则此缓冲区将接收重定向的本地设备的名称。
否则，复制到缓冲区的名称是远程资源的名称。 如果指定，则此缓冲区必须至少与 lpRemoteName 成员指向的字符串一样大。
[in, out] lpBufferSize
指向一个变量的指针，该变量指定 lpAccessName 缓冲区的大小（以字符为单位）。 如果调用失败，因为缓冲区不够大，该函数将返回此位置中所需的缓冲区大小。 有关详细信息，请参阅返回值部分中的 lpAccessName 参数的说明和ERROR_MORE_DATA错误代码。
[out] lpResult
指向接收有关连接的其他信息的变量的指针。 此参数可以是以下值。
| 价值 | 意义 |
|---|---|
|
如果设置了此标志，则使用本地设备重定向建立连接。 如果 lpAccessName 参数指向缓冲区，则本地设备名称将复制到缓冲区。 |
返回值
如果函数成功，则返回值NO_ERROR。
如果函数失败，则返回值为 系统错误代码，例如以下值之一。
| 返回代码 | 描述 |
|---|---|
|
调用方无权访问网络资源。 |
|
由 lpLocalName 成员指定的本地设备已连接到网络资源。 |
|
lpLocalName 指定的值无效。 |
|
lpRemoteName 成员指定的值对任何网络资源提供程序都不能接受，因为资源名称无效，或者因为命名资源无法找到。 |
|
由 lpProvider 成员指定的值与任何提供程序不匹配。 |
|
用户通过某个网络资源提供程序的对话框或调用的资源取消了进行连接尝试。 |
|
发生了特定于网络的错误。 若要获取错误的说明，请调用 WNetGetLastError 函数。 |
|
在指向无法访问的缓冲区的指针中传递的调用方。 |
|
此错误是以下条件之一的结果：
|
|
指定的密码无效，并且未设置CONNECT_INTERACTIVE标志。 |
|
lpAccessName 缓冲区太小。
如果重定向本地设备，缓冲区需要足够大才能包含本地设备名称。 否则，缓冲区必须足够大，才能包含由 lpRemoteName指向的字符串，或者 lpRemoteName指向其别名的可连接资源的名称。 如果返回此错误，则未建立任何连接。 |
|
操作系统无法自动选择本地重定向，因为所有有效的本地设备都正在使用。 |
|
由于网络组件未启动，或者无法识别指定的资源名称，因此无法完成该操作。 |
|
网络不可用。 |
言论
Windows Server 2003 和 Windows XP：WNet 函数在与登录会话关联的 MS-DOS 设备命名空间中创建和删除网络驱动器号，因为身份验证 ID 会标识 MS-DOS 设备。 （AuthenticationID 是与登录会话关联的 本地唯一标识符或 LUID。这可能会影响调用其中一个 WNet 函数的应用程序，以便在一个用户登录下创建网络驱动器号，但在其他用户登录下查询现有网络驱动器号。 例如，在登录会话中创建用户的第二次登录时，例如，通过调用 CreateProcessAsUser 函数，第二次登录运行调用 GetLogicalDrives 函数的应用程序。 GetLogicalDrives 不会返回由 WNet 函数在第一次登录下创建的网络驱动器号。 请注意，在前面的示例中，第一个登录会话仍然存在，该示例可以应用于任何登录会话，包括终端服务会话。 有关详细信息，请参阅 定义 MS-DOS 设备名称。
注意
winnetwk.h 标头将 WNetUseConnection 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | winnetwk.h |
| 库 | Mpr.lib |
| DLL | Mpr.dll |