À propos du serveur RAS et de l’administration de ports
Les fonctions d’administration du serveur RAS obtiennent des informations sur un serveur RAS spécifié et ses ports. Ces fonctions sont également utilisées pour arrêter une connexion sur un port de serveur RAS spécifié.
La fonction MprAdminServerGetInfo retourne une structure MPR_SERVER_0 qui contient des informations sur la configuration d’un serveur RAS. Les informations retournées incluent le nombre de ports actuellement disponibles pour les connexions, le nombre de ports actuellement utilisés et le numéro de version du serveur.
La fonction MprAdminPortEnum récupère un tableau de structures RAS_PORT_0 . Chaque structure contient des informations pour l’un des ports configurés sur un serveur RAS. Les informations relatives à chaque port sont les suivantes :
- Nom du port
- Informations sur l’appareil attaché au port
- Si le serveur RAS associé au port est un serveur Windows NT/Windows 2000 Server
- Indique si le port est en cours d’utilisation et, le cas échéant, des informations sur la connexion
Pour obtenir les ports utilisés par une connexion spécifique, transmettez Un handle MprAdminPortEnum à cette connexion dans le paramètre hConnection . Pour obtenir un handle pour une connexion, utilisez la fonction MprAdminConnectionEnum . Si vous avez implémenté une DLL d’administration RAS, les fonctions MprAdminAcceptNewConnection et MprAdminAcceptNewConnection2 reçoivent un handle pour chaque nouvelle connexion au moment de l’établissement de la connexion.
Vous pouvez appeler la fonction MprAdminPortGetInfo pour obtenir des informations supplémentaires sur un port spécifié sur un serveur RAS. Cette fonction retourne une structure RAS_PORT_1 qui contient une structure RAS_PORT_0 et des informations supplémentaires sur l’état actuel du port. La fonction RasAdminPortGetInfo retourne également un tableau de structures RAS_PARAMETERS qui décrivent les valeurs de toutes les clés spécifiques au média associées au port. Une structure RAS_PARAMETERS utilise une valeur de l’énumération RAS_PARAMS_FORMAT pour indiquer le format de la valeur pour chaque clé spécifique au média.
La fonction MprAdminPortGetInfo retourne également une structure RAS_PORT_STATISTICS qui contient différents compteurs statistiques pour la connexion actuelle, le cas échéant, sur le port. Pour un port faisant partie d’une connexion multilink, MprAdminPortGetInfo retourne des statistiques pour le port individuel et des statistiques cumulatives pour tous les ports impliqués dans la connexion. Vous pouvez utiliser la fonction MprAdminPortClearStats pour réinitialiser les compteurs de statistiques pour le port. La fonction MprAdminPortDisconnect déconnecte un port en cours d’utilisation.
Utilisez la fonction MprAdminBufferFree pour libérer la mémoire allouée par les fonctions MprAdminPortEnum et MprAdminPortGetInfo . Utilisez la fonction MprAdminGetErrorString pour obtenir une chaîne qui décrit un code d’erreur RAS retourné par l’une des fonctions d’administration du serveur RAS (RasAdmin).