通过

MprAdminUserSetInfo 函数 (mprapi.h)

  • 项目

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

另请参阅

MprAdminGetPDCServer

MprAdminUserGetInfo

RAS 管理功能

RAS_USER_0

远程访问服务管理参考