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。 否则，它应返回错误代码，可以是以下代码之一。

返回代码 说明
WN_NOT_CONNECTED
 lpName 参数中的值不是重定向设备的名称或连接的远程名称。
WN_MORE_DATA
 缓冲区 lpUserName 太小。
WN_NO_NETWORK
 网络不存在。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 npapi.h