Présentation des fonctions de gestion des routeurs
Les sections suivantes décrivent les différents types de fonctions de gestion des routeurs et ce que vous devez savoir pour les utiliser efficacement.
Toutes les fonctions de gestion des routeurs nécessitent des privilèges d’administrateur. Un utilisateur du groupe Power User ne dispose pas des privilèges suffisants pour utiliser les fonctions de gestion du routeur.
Les différentes classes de fonctions de gestion des routeurs
Les fonctions de gestion des routeurs peuvent être divisées en fonctions d’administration et fonctions de configuration. Les fonctions d’administration ont le préfixe MprAdmin et les fonctions de configuration ont le préfixe MprConfig. Malgré le nommage, les deux ensembles de fonctions sont utilisés pour la gestion des routeurs. Les fonctions MprAdmin fonctionnent directement sur le routeur en cours d’exécution. Les fonctions MprConfig ont des fonctionnalités similaires, mais fonctionnent sur la configuration du routeur stockée dans le Registre. Les deux types de fonctions passent des blocs d’informations.
Les fonctions de gestion des routeurs peuvent également être divisées en fonction des composants du routeur qu’elles gèrent : interfaces, gestionnaires de routeurs ou clients gestionnaires de routeurs.
Les fonctions d’interface du routeur ont le préfixe MprAdminInterface ou MprConfigInterface. Utilisez ces fonctions pour accéder aux interfaces. Les fonctions du gestionnaire de routeur ont le préfixe MprAdminTransport ou MprConfigTransport. Utilisez ces fonctions pour accéder aux gestionnaires de routeur. Enfin, les fonctions clientes du gestionnaire de routeur ont le préfixe MprAdminInterfaceTransport ou MprConfigInterfaceTransport. Utilisez ces fonctions pour accéder aux clients en cours d’exécution sur le routeur.
Un sous-ensemble des fonctions MprAdmin sont les fonctions MprAdminMib. Elles fonctionnent également sur l’itinéraire en cours d’exécution. Toutefois, ces fonctions ne passent pas de blocs d’informations. Ces fonctions offrent une flexibilité supplémentaire au concepteur de protocole, en particulier pour récupérer des informations non liées à la configuration, telles que des statistiques.
S’assurer que les modifications se produisent immédiatement et qu’elles sont persistantes
Un développeur peut apporter des modifications à la configuration du routeur directement à l’aide des fonctions de configuration du routeur. Toutefois, les modifications apportées à la configuration ne prennent pas effet tant que le routeur n’est pas redémarré, car c’est la seule fois que DIM lit la configuration à partir du Registre.
Un développeur peut apporter des modifications au routeur en cours d’exécution à l’aide des fonctions d’administration du routeur. Toutefois, ces modifications ne sont pas persistantes : comme elles n’ont pas été écrites dans le Registre, elles sont perdues si le routeur est redémarré.
Pour apporter des modifications immédiates et persistantes, un développeur doit utiliser à la fois l’administration du routeur et les fonctions de configuration du routeur. Si le routeur n’est pas en cours d’exécution, le développeur n’a besoin que d’appeler les fonctions de configuration de routeur appropriées.
Pour interroger des informations à partir du routeur en cours d’exécution, utilisez les fonctions d’administration du routeur. Si le routeur n’est pas en cours d’exécution, interrogez les informations à l’aide des fonctions de configuration du routeur.
Les fonctions MprAdminInterfaceCreate et MprAdminInterfaceSetInfo prennent en charge la structure MPR_INTERFACE_2 . Toutefois, MprConfigInterfaceCreate et MprConfigInterfaceSetInfo ne le font pas. Pour créer une interface de numérotation à la demande persistante après un redémarrage, appelez MprAdminInterfaceCreate avec MPR_INTERFACE_2, puis appelez MprConfigInterfaceCreate avec MPR_INTERFACE_0 ou MPR_INTERFACE_1. De même, pour apporter des modifications persistantes à une interface de numérotation à la demande, appelez MprAdminInterfaceSetInfo avec MPR_INTERFACE_2, puis appelez MprConfigInterfaceSetInfo avec MPR_INTERFACE_0 ou MPR_INTERFACE_1.
Utilisation à distance des fonctions d’administration et de configuration du routeur
La plupart des fonctions d’administration et de configuration du routeur peuvent être appelées sur un ordinateur autre que celui administré. Ces fonctions prennent comme paramètre, un handle pour le service de routeur ou la configuration à administrer. Les fonctions d’administration utilisent RPC (Remote Procedure Call) pour communiquer avec le service de routage spécifié par le handle. Les fonctions de configuration écrivent et lisent dans le registre de l’ordinateur spécifié par le handle.
Pour administrer le service de routage sur un ordinateur distant, appelez d’abord MprAdminIsServiceRunning pour vérifier que le service est en cours d’exécution. Appelez ensuite MprAdminServerConnect pour obtenir le handle. Si le service de routeur n’est pas en cours d’exécution sur l’ordinateur distant, tous les appels d’administration de routeur (MprAdmin) échouent.
Pour apporter des modifications à la configuration du routeur sur un ordinateur distant, obtenez un handle en appelant la fonction MprConfigServerConnect .