检索当前默认用户名或用于建立网络连接的用户名的值。
Syntax
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。 否则,它应返回错误代码,可以是以下代码之一。
| 返回代码 | Description |
|---|---|
|
lpName 参数中的值不是重定向设备的名称或连接的远程名称。 |
|
缓冲区 lpUserName 太小。 |
|
网络不存在。 |
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | npapi.h |
| Library | davclnt.lib |