NPGetUser 函数 (npapi.h)

检索当前默认用户名或用于建立网络连接的用户名的值。

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
WN_NOT_CONNECTED
lpName 参数中的值不是重定向设备的名称或连接的远程名称。
WN_MORE_DATA
缓冲区 lpUserName 太小。
WN_NO_NETWORK
网络不存在。

要求

Requirement 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows操作系统
Header npapi.h
Library davclnt.lib