WNetGetUser功能检索用于建立网络连接的当前默认用户名或用户名。
// pointer to local name to get user name for
LPCTSTR 【lpName】, | //指向本地名称以获取用户名 |
LPTSTR 【lpUserName】, | //指向缓冲区的用户名 |
LPDWORD 【lpnLength】 | //指向缓冲区大小变量的指针 |
); |
参数
【lpName】
指向以空值终止的字符串,指定已重定向到网络资源的本地设备的名称,或指定已建立连接的网络资源的远程名称。
如果此参数为NULL,Windows将返回该进程的当前用户的名称。
【lpUserName】
指向接收以零结尾的用户名的缓冲区。
【lpnLength】
指向一个变量,指定【lpUserName】指向的缓冲区大小(以字符为单位)。如果调用失败,因为缓冲区不够大,此变量包含所需的缓冲区大小。
返回值
如果函数成功,返回值为NO_ERROR。
如果函数失败,则返回值是错误代码。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
值 | 含义 |
ERROR_NOT_CONNECTED | 由【lpName】指定的设备不??是重定向设备或已连接的网络名称。 |
ERROR_MORE_DATA | 更多条目可用于后续呼叫。 |
ERROR_NO_NETWORK | 没有网络。 |
ERROR_EXTENDED_ERROR | 发生网络特定错误。要获取错误的描述,请使用WNetGetLastError功能。 |
ERROR_NO_NET_OR_BAD_PATH | 没有一个提供商将本地名称识别为具有连接。但是,该网络不可用于连接可能属于的至少一个提供商。 |
该函数返回与Windows 3.1版兼容的错误代码。为了与Win32 API兼容,该函数还设置GetLastError返回的错误代码值。
也可以看看