Función MprAdminGetPDCServer (mprapi.h)

Artículo
03/15/2023

La función MprAdminGetPDCServer recupera el nombre del servidor con el Subsistema de cuentas de usuario maestras (UAS) de un nombre de dominio o un nombre de servidor. El parámetro domain name o el parámetro server name pueden ser NULL, pero no ambos.

Sintaxis

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

Parámetros

[in] lpszDomain

Puntero a una cadena Unicode terminada en NULL que especifica el nombre del dominio al que pertenece el servidor RAS. Este parámetro puede ser NULL si ejecuta la aplicación de administración ras en un servidor Windows NT/Windows 2000 que no participa en un dominio. Si este parámetro es NULL, el parámetro lpwsServerName no debe ser NULL.

[in] lpszServer

Puntero a una cadena Unicode terminada en null que especifica el nombre del servidor RAS de Windows NT/Windows 2000. Especifique el nombre con caracteres "\" iniciales, con el formato \servername. Este parámetro puede ser NULL si el parámetro lpwsDomain no es NULL.

[out] lpszPDCServer

Puntero a un búfer que recibe una cadena Unicode terminada en null que contiene el nombre de un controlador de dominio que tiene la base de datos de la cuenta de usuario. El búfer debe ser lo suficientemente grande como para contener el nombre del servidor (UNCLEN +1). La función prefijo el nombre del servidor devuelto con caracteres "\" iniciales, con el formato: \servername.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes valores.

Valor	Significado
ERROR_NO_SUCH_DOMAIN	El dominio especificado no es válido.
NERR_InvalidComputer	El parámetro lpwsDomainName es NULL y el parámetro lpwsServerName no es válido.

Comentarios

La función MprAdminGetPDCServer puede obtener el nombre del servidor con la base de datos de cuentas de usuario según el nombre del servidor RAS o el nombre del dominio en el que reside el servidor RAS. Para obtener el nombre del servidor, llame a la función GetComputerName .

Si el nombre del servidor especificado por lpszServer forma parte de un dominio, el servidor devuelto por MprAdminGetPDCServer será el controlador de dominio principal o un controlador de dominio de copia de seguridad.

Si el nombre del servidor especificado por lpszServer es un servidor independiente de Windows NT/Windows 2000 (es decir, el servidor o la estación de trabajo no participa en un dominio), el propio nombre del servidor se devuelve en el búfer lpszUserAccountServer .

A continuación, puede usar el nombre del servidor de cuentas de usuario en una llamada a la función NetQueryDisplayInformation para enumerar los usuarios de la base de datos de cuentas de usuario. También puede usar el nombre del servidor en llamadas a las funciones MprAdminUserGetInfo y MprAdminUserSetInfo para obtener y establecer privilegios RAS para una cuenta de usuario especificada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mprapi.h
Library	Mprapi.lib
Archivo DLL	Mprapi.dll