MprAdminUserGetInfo 函数 (mprapi.h)

项目
03/13/2024

MprAdminUserGetInfo 函数检索特定用户的所有 RAS 信息。

语法

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

参数

[in] lpszServer

指向 Unicode 字符串的指针，该字符串指定主用户帐户子系统 (UAS) 的服务器的名称。如果远程访问服务器是域的一部分，则具有 UAS 的计算机是主域控制器或备份域控制器。如果远程访问服务器不是域的一部分，则服务器本身将存储 UAS。在任一情况下，调用 MprAdminGetPDCServer 函数以获取此参数的值。

如果服务器本身存储 UAS，则此参数可以为 NULL。

[in] lpszUser

指向 Unicode 字符串的指针，该字符串指定要获取 RAS 信息的用户的名称。

[in] dwLevel

此参数可以是零或 1。

Windows NT SP3 及更高版本的 Server 4.0：此参数必须为零。

[out] lpbBuffer

指向 RAS_USER_0 或 RAS_USER_1 结构的指针。调用方必须为此结构分配 (和释放) 内存。成功返回后，此结构包含指定用户的 RAS 数据。

Windows NT SP3 及更高版本的 Server 4.0：如果 dwLevel 参数指定零，则 lpbBuffer 应指向RAS_USER_0结构。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下值之一。

值	含义
ERROR_ACCESS_DENIED	调用方没有足够的权限。
ERROR_INVALID_LEVEL	dwLevel 的值无效。
ERROR_INVALID_PARAMETER	lpbBuffer 为 NULL
ERROR_NO_SUCH_USER	lpwsUserName 指定的用户不存在于 lpwsServerName 指定的服务器上。

注解

如果安装了 RRAS 可再发行组件，则此函数在 Windows NT 4.0 上可用。但是，RRAS 可再发行组件附带的 Mprapi.dll 版本将函数导出为 RasAdminUserGetInfo ，而不是 MprAdminUserGetInfo。因此，使用 RRAS 可再发行组件时，请使用 LoadLibrary 和 GetProcAddress 访问此函数。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	mprapi.h
Library	Mprapi.lib
DLL	Mprapi.dll