À propos de l’administration du serveur et du port RAS

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 mettre fin à 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 en cours d’utilisation et le numéro de version du serveur.

La fonction MprAdminPortEnum récupère un tableau de structures du _ port RAS _ 0 . Chaque structure contient des informations sur l’un des ports configurés sur un serveur RAS. Les informations de chaque port incluent :

  • Nom du port
  • Informations sur l’appareil attaché au port
  • si le serveur RAS associé au port est un serveur Windows NT/Windows 2000
  • Si le port est en cours d’utilisation et, si c’est le cas, des informations sur la connexion ;

Pour obtenir les ports utilisés par une connexion spécifique, transmettez MprAdminPortEnum un handle à cette connexion dans le paramètre hConnection . Pour obtenir un descripteur d’une connexion, utilisez la fonction MprAdminConnectionEnum . Sinon, 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 où la connexion est établie.

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 de _ port RAS _ 1 qui contient une structure de _ port RAS _ 0 et des informations supplémentaires sur l’état actuel du port. La fonction RasAdminPortGetInfo retourne également un tableau de structures de _ paramètres RAS qui décrivent les valeurs de toutes les clés spécifiques au média associées au port. Une structure de _ paramètres RAS utilise une valeur de l’énumération de _ _ format params des paramètres d’accès distant pour indiquer le format de la valeur pour chaque clé spécifique au média.

La fonction MprAdminPortGetInfo retourne également une structure de _ _ statistiques de port RAS qui contient différents compteurs de statistiques pour la connexion actuelle, le cas échéant, sur le port. Pour un port qui fait partie d’une connexion à liaisons multiples, 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 des statistiques du port. La fonction MprAdminPortDisconnect déconnecte un port en cours d’utilisation.

Utilisez la fonction MprAdminBufferFree pour libérer de 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 renvoyé par l’une des fonctions d’administration de serveur RAS (RasAdmin).