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 |
|---|---|
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|