MprAdminUserSetInfo 函数 (mprapi.h)

项目
08/24/2023

MprAdminUserSetInfo 函数为指定用户设置 RAS 信息。

语法

DWORD MprAdminUserSetInfo(
  [in] LPCWSTR      lpszServer,
  [in] LPCWSTR      lpszUser,
  [in] DWORD        dwLevel,
  [in] const LPBYTE lpbBuffer
);

parameters

[in] lpszServer

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

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

[in] lpszUser

指向 Unicode 字符串的指针，该字符串指定要为其设置 RAS 信息的用户的名称。

[in] dwLevel

此参数可以是零或 1，对应于 lpbBuffer 参数指向的结构类型。

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

[in] lpbBuffer

指向 RAS_USER_0 或 RAS_USER_1 结构的指针，该结构指定用户的新 RAS 信息。

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

返回值

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

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

值	含义
ERROR_ACCESS_DENIED	调用方没有足够的权限。
错误_INVALID_LEVEL	dwLevel 的值无效。
ERROR_NOT_ENOUGH_MEMORY	资源不足，无法完成操作。
ERROR_NO_SUCH_USER	lpwsUserName 指定的用户不存在于 lpwsServerName 指定的服务器上。

注解

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

要求


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