WNetGetConnection

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

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