RasAdminGetUserAccountServer 函数
[此函数仅用于向后兼容 Windows NT Server 4.0。 它在 Windows Server 2003 上返回ERROR_CALL_NOT_IMPLEMENTED。 应用程序应使用 MprAdminGetPDCServer 函数。]
RasAdminGetUserAccountServer 函数检索具有用户帐户数据库的服务器的名称。 使用 RasAdminUserGetInfo 和 RasAdminUserSetInfo 函数中返回的服务器名称来获取或设置有关指定用户的信息。
语法
DWORD RasAdminGetUserAccountServer(
_In_ const WCHAR *lpszDomain,
_In_ const WCHAR *lpszServer,
_Out_ LPWSTR lpszUserAccountServer
);
参数
-
lpszDomain [in]
-
指向 以 null 结尾的 Unicode 字符串的指针，该字符串指定 RAS 服务器所属的域的名称。 对于在非域成员的工作站或服务器上运行的 RAS 管理应用程序，此参数为 NULL 。 如果此参数为 NULL，则 lpszServer 参数必须为非 NULL。
-
lpszServer [in]
-
指向以 null 结尾的 Unicode 字符串的指针，该字符串指定 RAS 服务器的名称。 指定具有前导“\\”字符的名称，格式为：\\servername。 如果 lpszDomain 参数不为 NULL，则此参数可以为 NULL。
-
lpszUserAccountServer [out]
-
指向一个缓冲区的指针，该缓冲区接收以 null 结尾的 Unicode 字符串，该字符串指定具有用户帐户数据库的域控制器的名称。 缓冲区应足够大，以便将服务器名称保留 (UNCLEN +1) 。 函数为返回的服务器名称添加前导“\\”字符前缀，格式为：\\servername。
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值可能是以下错误代码。
| 值 | 含义 |
|---|---|
|
lpszDomain 和 lpszServer 均为 NULL。 |
此函数没有扩展的错误信息;不要调用 GetLastError。
备注
RasAdminGetUserAccountServer 函数使用用户帐户数据库获取服务器的名称。 此函数需要 RAS 服务器的名称或 RAS 服务器所在的域的名称。
lpszDomain 参数应指定有效的域名。 对于在不是域成员的服务器上运行的 RAS 管理应用程序，此参数为 NULL (例如，服务器位于其自己的工作组) 中。 在这种情况下， lpszServer 参数必须指定服务器名称。 若要获取服务器名称，请调用 GetComputerName 函数。 请务必在服务器名称前面加上“\\”字符。
如果 lpszServer 指定的服务器名称是独立服务器 (即服务器或工作站不是域) 的成员，则在 lpszUserAccountServer 缓冲区中返回服务器名称本身。
然后在调用 NetQueryDisplayInformation 函数时使用用户帐户服务器的名称来枚举用户帐户数据库中的用户。
要求
| 要求 | 值 |
|---|---|
| 客户端支持终止 |
Windows 2000 Professional |
| 终止服务器支持 |
Windows 2000 Server |
| 标头 |
|
| 库 |
|
| DLL |
|