WNetAddConnection功能使呼叫应用程序能够将本地设备连接到网络资源。一个成功的连接是持久的,这意味着Windows会在后续的登录操作中自动恢复连接。
提供此函数以兼容早期版本的Microsoft Windows。对于新的应用程序,请使用WNetAddConnection2功能。
DWORD WNetAddConnection(
LPTSTR 【lpRemoteName】, | //指向网络设备名称的指针 |
LPTSTR 【//指向密码字符串的指针】, | //指向密码的指针 |
LPTSTR 【lpLocalName】 | //指向本地设备名称的指针 |
); |
参数
【lpRemoteName】
指向指定要连接到的网络资源的以空字符结尾的字符串。
【//指向密码字符串的指针】
指向以空字符结尾的字符串,指定用于进行连接的密码。此参数通常是与当前用户相关联的密码。
如果此参数为NULL,则使用默认密码。如果字符串为空,则不使用密码。
【lpLocalName】
指向指定要重定向的本地设备的名称的空终止字符串,例如F:或LPT1。字符串中的字符的情况并不重要。如果字符串为NULL,则连接到网络资源而不重定向本地设备。
返回值
如果函数成功,返回值为NO_ERROR。
如果函数失败,则返回值是错误代码。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
值 | 含义 |
ERROR_ACCESS_DENIED | 访问被拒绝。 |
ERROR_ALREADY_ASSIGNED | 【lpLocalName】参数中指定的设备已连接。 |
ERROR_BAD_DEV_TYPE | 设备类型和资源类型不匹配。 |
ERROR_BAD_DEVICE | 【lpLocalName】中指定的值无效。 |
ERROR_BAD_NET_NAME | 【lpRemoteName】参数中指定的值无效或无法找到。 |
ERROR_BAD_PROFILE | 用户配置文件的格式不正确。 |
ERROR_CANNOT_OPEN_PROFILE | 系统无法打开用户配置文件以处理持久连接。 |
ERROR_DEVICE_ALREADY_REMEMBERED | 【lpLocalName】中指定的设备的条目已在用户配置文件中。 |
ERROR_EXTENDED_ERROR | 发生网络特定错误。要获取错误的描述,请使用WNetGetLastError功能。 |
ERROR_INVALID_PASSWORD | 指定的密码无效。 |
ERROR_NO_NET_OR_BAD_PATH | 无法执行操作,因为网络组件未启动或不能使用指定的名称。 |
ERROR_NO_NETWORK | 网络不存在。 |
该函数返回错误代码并设置GetLastError返回的错误代码值。
也可以看看
WNetAddConnection2, WNetCancelConnection, WNetCancelConnection2, WNetGetConnection, WNetGetLastError