NPGetUser 函数 (npapi.h)
检索当前默认用户名或用于建立网络连接的用户名的值。
语法
DWORD NPGetUser(
[in] LPWSTR lpName,
[out] LPWSTR lpUserName,
[in, out] LPDWORD lpnBufferLen
);
参数
[in] lpName
指向调用方感兴趣的本地设备名称的指针,或者用户已连接到的资源的远程名称。 如果调用方对当前登录到系统的用户的名称感兴趣,则此参数可以是 NULL 或空字符串。 如果传入了资源的远程名称,并且用户使用不同的名称连接到该资源,则提供程序可能无法解析要返回的用户名。 在这种情况下,提供程序可以在可能的用户名之间进行任意选择。
[out] lpUserName
指向用于接收用户名的缓冲区的指针。 这应该是可以传递到 NPAddConnection 或 NPAddConnection3 函数的名称,以使用相同的用户名重新建立连接。
[in, out] lpnBufferLen
指向 lpUserName 缓冲区的大小(以字符为单位)的指针。 如果调用因缓冲区不够大而失败,则将使用此位置返回所需的缓冲区大小。
返回值
如果该函数成功,则它应返回WN_SUCCESS。 否则,它应返回错误代码,可以是以下代码之一。
返回代码 | 说明 |
---|---|
|
lpName 参数中的值不是重定向设备的名称或连接的远程名称。 |
|
缓冲区 lpUserName 太小。 |
|
网络不存在。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | npapi.h |