Acerca del servidor RAS y la administración de puertos
Las funciones de administración del servidor RAS obtienen información sobre un servidor RAS especificado y sus puertos. Estas funciones también se usan para finalizar una conexión en un puerto de servidor RAS especificado.
La función MprAdminServerGetInfo devuelve una estructura MPR_SERVER_0 que contiene información sobre la configuración de un servidor RAS. La información devuelta incluye el número de puertos disponibles actualmente para las conexiones, el número de puertos actualmente en uso y el número de versión del servidor.
La función MprAdminPortEnum recupera una matriz de estructuras RAS_PORT_0 . Cada estructura contiene información para uno de los puertos configurados en un servidor RAS. La información de cada puerto incluye:
- Nombre del puerto
- Información sobre el dispositivo conectado al puerto
- Si el servidor RAS asociado al puerto es un servidor Windows NT/Windows 2000
- Si el puerto está actualmente en uso y, si es así, información sobre la conexión
Para obtener los puertos que usa una conexión específica, pase MprAdminPortEnum un identificador a esa conexión en el parámetro hConnection . Para obtener un identificador de una conexión, use la función MprAdminConnectionEnum . Como alternativa, si ha implementado un archivo DLL de administración de RAS, las funciones MprAdminAcceptNewConnection y MprAdminAcceptNewConnection2 reciben un identificador para cada conexión nueva en el momento en que se establece la conexión.
Puede llamar a la función MprAdminPortGetInfo para obtener información adicional sobre un puerto especificado en un servidor RAS. Esta función devuelve una estructura RAS_PORT_1 que contiene una estructura de RAS_PORT_0 e información adicional sobre el estado actual del puerto. La función RasAdminPortGetInfo también devuelve una matriz de estructuras de RAS_PARAMETERS que describen los valores de las claves específicas de medios asociadas al puerto. Una estructura RAS_PARAMETERS usa un valor de la enumeración RAS_PARAMS_FORMAT para indicar el formato del valor de cada clave específica del medio.
La función MprAdminPortGetInfo también devuelve una estructura de RAS_PORT_STATISTICS que contiene varios contadores estadísticos para la conexión actual, si existe, en el puerto. Para un puerto que forma parte de una conexión de varios vínculos, MprAdminPortGetInfo devuelve estadísticas para el puerto individual y las estadísticas acumulativas de todos los puertos implicados en la conexión. Puede usar la función MprAdminPortClearStats para restablecer los contadores estadísticos del puerto. La función MprAdminPortDisconnect desconecta un puerto que está en uso.
Use la función MprAdminBufferFree para liberar memoria asignada por las funciones MprAdminPortEnum y MprAdminPortGetInfo . Use la función MprAdminGetErrorString para obtener una cadena que describe un código de error RAS devuelto por una de las funciones de administración del servidor RAS (RasAdmin).