WNetGetUser

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

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返回的错误代码值。

也可以看看

WNetGetConnection, WNetGetLastError