Función RasAdminGetUserAccountServer

[Esta función solo se proporciona para la compatibilidad con versiones anteriores con Windows NT Server 4.0. Devuelve ERROR_CALL_NOT_IMPLEMENTED en Windows Server 2003. Las aplicaciones deben usar la función MprAdminGetPDCServer .]

La función RasAdminGetUserAccountServer recupera el nombre del servidor que tiene la base de datos de la cuenta de usuario. Use el nombre de servidor devuelto en las funciones RasAdminUserGetInfo y RasAdminUserSetInfo para obtener o establecer información sobre un usuario especificado.

Sintaxis

DWORD RasAdminGetUserAccountServer(
  _In_  const WCHAR  *lpszDomain,
  _In_  const WCHAR  *lpszServer,
  _Out_       LPWSTR lpszUserAccountServer
);

Parámetros

lpszDomain [in]

Puntero a una cadena Unicode terminada en null que especifica el nombre del dominio al que pertenece el servidor RAS. Este parámetro es NULL para las aplicaciones de administración ras que se ejecutan en estaciones de trabajo o servidores que no son miembros de un dominio. Si este parámetro es NULL, el parámetro lpszServer debe ser distinto de NULL.

lpszServer [in]

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

lpszUserAccountServer [out]

Puntero a un búfer que recibe una cadena Unicode terminada en null que especifica 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 : \\nombreServidor.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto puede ser el siguiente código de error.

Valor	Significado
ERROR_INVALID_PARAMETER	LpszDomain y lpszServer son NULL.

No hay información de error extendida para esta función; no llame a GetLastError.

Comentarios

La función RasAdminGetUserAccountServer obtiene el nombre del servidor con la base de datos de cuentas de usuario. Esta función requiere el nombre del servidor RAS o el nombre del dominio en el que reside el servidor RAS.

El parámetro lpszDomain debe especificar un nombre de dominio válido. Este parámetro es NULL para las aplicaciones de administración ras que se ejecutan en servidores que no son miembros de un dominio (por ejemplo, el servidor está en su propio grupo de trabajo). En este caso, el parámetro lpszServer debe especificar el nombre del servidor. Para obtener el nombre del servidor, llame a la función GetComputerName . Asegúrese de prefijar el nombre del servidor con los caracteres "\\".

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

A continuación, use 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.

Requisitos

Requisito	Value
Fin de compatibilidad de cliente	Windows 2000 Professional
Fin de compatibilidad de servidor	Windows 2000 Server
Encabezado	Rassapi.h
Biblioteca	Rassapi.lib
Archivo DLL	Rassapi.dll

Consulte también

Información general sobre el servicio de acceso remoto (RAS)

Funciones de administración del servidor RAS

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo