WNetAddConnection

【勇芳软件工作室】汉化HomePreviousNext

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