MprAdminGetPDCServer 函数 (mprapi.h)

项目
08/24/2023

MprAdminGetPDCServer 函数使用主用户帐户子系统 (UAS) 从域名或服务器名称检索服务器的名称。域名参数或服务器名称参数可以为 NULL，但不能同时为 NULL。

语法

DWORD MprAdminGetPDCServer(
  [in]  LPCWSTR lpszDomain,
  [in]  LPCWSTR lpszServer,
  [out] LPWSTR  lpszPDCServer
);

参数

[in] lpszDomain

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定 RAS 服务器所属的域的名称。如果在未参与域的 Windows NT/Windows 2000 服务器上运行 RAS 管理应用程序，则此参数可以为 NULL。如果此参数为 NULL，则 lpwsServerName 参数不得为 NULL。

[in] lpszServer

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定 Windows NT/Windows 2000 RAS 服务器的名称。指定带有前导“\”字符的名称，格式为： \servername。如果 lpwsDomain 参数不为 NULL，此参数可以为 NULL。

[out] lpszPDCServer

指向接收以 null 结尾的 Unicode 字符串的缓冲区的指针，该字符串包含具有用户帐户数据库的域控制器的名称。缓冲区应足够大， (UNCLEN +1) 保存服务器名称。函数在返回的服务器名称前面加上前导“\”字符，格式为： \servername。

返回值

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

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

值	含义
ERROR_NO_SUCH_DOMAIN	指定的域无效。
NERR_InvalidComputer	lpwsDomainName 参数为 NULL，lpwsServerName 参数无效。

注解

MprAdminGetPDCServer 函数可以使用用户帐户数据库获取服务器的名称，给定 RAS 服务器的名称或 RAS 服务器所在的域的名称。若要获取服务器名称，请调用 GetComputerName 函数

如果 lpszServer 指定的服务器名称是域的一部分，则 MprAdminGetPDCServer 返回的服务器将是主域控制器或备份域控制器。

如果 lpszServer 指定的服务器名称是独立的 Windows NT/Windows 2000 服务器 (即服务器或工作站不参与域) ，则服务器名称本身将在 lpszUserAccountServer 缓冲区中返回。

然后，可以在调用 NetQueryDisplayInformation 函数时使用用户帐户服务器的名称来枚举用户帐户数据库中的用户。还可以在调用 MprAdminUserGetInfo 和 MprAdminUserSetInfo 函数时使用服务器名称来获取和设置指定用户帐户的 RAS 特权。

要求

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