WNetGetConnection功能检索与本地设备关联的网络资源的名称。
DWORD WNetGetConnection(
LPCTSTR 【lpLocalName】, | //指向本地名称的指针 |
LPTSTR 【lpRemoteName】, | //指向缓冲区的远程名称 |
LPDWORD 【lpnLength】 | //指向缓冲区大小的字符 |
); |
参数
【lpLocalName】
指向以null结尾的字符串,指定获取网络名称的本地设备的名称。
【lpRemoteName】
指向缓冲区,接收用于进行连接的以空值终止的远程名称。
【lpnLength】
指向一个变量,指定【lpRemoteName】参数指向的缓冲区大小(以字符为单位)。如果该函数因缓冲区不够大而失败,则该参数返回所需的缓冲区大小。
返回值
如果函数成功,返回值为NO_ERROR。
如果函数失败,则返回值是错误代码。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
值 | 含义 |
ERROR_BAD_DEVICE | 【lpLocalName】参数指向的字符串无效。 |
ERROR_NOT_CONNECTED | 【lpLocalName】指定的设备未重定向。 |
ERROR_MORE_DATA | 缓冲区太小了。【lpnLength】参数指向包含所需缓冲区大小的变量。更多条目可用于后续呼叫。 |
ERROR_CONNECTION_UNAVAIL | 该设备当前未连接,但它是持续连接。 |
ERROR_NO_NETWORK | 没有网络。 |
ERROR_EXTENDED_ERROR | 发生网络特定错误。要获取错误的描述,请使用WNetGetLastError功能。 |
ERROR_NO_NET_OR_BAD_PATH | 没有一个提供商将本地名称识别为具有连接。但是,该网络不可用于连接可能属于的至少一个提供商。 |
WNetGetConnection函数返回与Windows 3.1版兼容的错误代码。为了与Win32 API兼容,该函数还设置GetLastError返回的错误代码值。
也可以看看
WNetAddConnection2, WNetAddConnection3, WNetGetLastError, WNetGetUser