Función MprAdminUserGetInfo (mprapi.h)
La función MprAdminUserGetInfo recupera toda la información de RAS para un usuario determinado.
Sintaxis
DWORD MprAdminUserGetInfo(
[in] LPCWSTR lpszServer,
[in] LPCWSTR lpszUser,
[in] DWORD dwLevel,
[out] LPBYTE lpbBuffer
);
Parámetros
[in] lpszServer
Puntero a una cadena Unicode que especifica el nombre del servidor con el Subsistema de cuentas de usuario maestras (UAS). Si el servidor de acceso remoto forma parte de un dominio, el equipo con UAS es el controlador de dominio principal o el controlador de dominio de copia de seguridad. Si el servidor de acceso remoto no forma parte de un dominio, el propio servidor almacena el UAS. En cualquier caso, llame a la función MprAdminGetPDCServer para obtener el valor de este parámetro.
Si el propio servidor almacena el UAS, este parámetro puede ser NULL.
[in] lpszUser
Puntero a una cadena Unicode que especifica el nombre del usuario para el que se va a obtener información de RAS.
[in] dwLevel
Este parámetro puede ser cero o uno.
Windows NT Server 4.0 con SP3 y versiones posteriores: Este parámetro debe ser cero.
[out] lpbBuffer
Puntero a una estructura de RAS_USER_0 o RAS_USER_1 . El autor de la llamada debe asignar (y liberar) la memoria de esta estructura. Tras la devolución correcta, esta estructura contiene los datos ras del usuario especificado.
Windows NT Server 4.0 con SP3 y versiones posteriores: Si el parámetro dwLevel especifica cero, lpbBuffer debe apuntar a una estructura de RAS_USER_0 .
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 |
|---|---|
|
El autor de la llamada no tiene privilegios suficientes. |
|
El valor de dwLevel no es válido. |
|
lpbBuffer es NULL |
|
El usuario especificado por lpwsUserName no existe en el servidor especificado por lpwsServerName. |
Comentarios
Esta función está disponible en Windows NT 4.0 si está instalado el redistribuible RRAS. Sin embargo, la versión de Mprapi.dll que se incluye con el redistribuible RRAS exporta la función como RasAdminUserGetInfo en lugar de MprAdminUserGetInfo. Por lo tanto, al usar el redistribuible RRAS, use LoadLibrary y GetProcAddress para acceder a esta función.
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 |