Grundlegendes zu Routerverwaltungsfunktionen

In den folgenden Abschnitten werden die verschiedenen Typen von Routerverwaltungsfunktionen und ihre effektive Verwendung erläutert.

Alle Routerverwaltungsfunktionen erfordern Administratorrechte. Ein Benutzer in der Power User-Gruppe verfügt nicht über ausreichende Berechtigungen zum Verwenden der Routerverwaltungsfunktionen.

Die verschiedenen Klassen von Routerverwaltungsfunktionen

Die Routerverwaltungsfunktionen können in die Verwaltungsfunktionen und die Konfigurationsfunktionen unterteilt werden. Die Verwaltungsfunktionen haben das Präfix MprAdmin und die Konfigurationsfunktionen das Präfix MprConfig. Trotz der Benennung werden beide Sätze von Funktionen für die Routerverwaltung verwendet. Die MprAdmin-Funktionen arbeiten direkt auf dem ausgeführten Router. Die MprConfig-Funktionen verfügen über ähnliche Funktionen, arbeiten jedoch mit der Routerkonfiguration, die in der Registrierung gespeichert ist. Beide Funktionstypen übergeben Informationsblöcke.

Die Routerverwaltungsfunktionen können auch basierend darauf aufgeteilt werden, welche Komponenten des Routers sie verwalten: Schnittstellen, Router-Manager oder Router-Manager-Clients.

Die Routerschnittstellenfunktionen haben das Präfix MprAdminInterface oder MprConfigInterface. Verwenden Sie diese Funktionen, um auf Schnittstellen zuzugreifen. Die Router-Manager-Funktionen haben das Präfix MprAdminTransport oder MprConfigTransport. Verwenden Sie diese Funktionen, um auf die Router-Manager zuzugreifen. Schließlich haben die Clientfunktionen des Router-Managers das Präfix MprAdminInterfaceTransport oder MprConfigInterfaceTransport. Verwenden Sie diese Funktionen, um auf die Clients zuzugreifen, die auf dem Router ausgeführt werden.

Eine Teilmenge der MprAdmin-Funktionen sind die MprAdminMib-Funktionen. Diese werden auch allein auf der ausgeführten Route ausgeführt. Diese Funktionen übergeben jedoch keine Informationsblöcke. Diese Funktionen bieten dem Protokoll-Designer zusätzliche Flexibilität, insbesondere beim Abrufen von Nichtkonfigurationsinformationen wie Statistiken.

Sicherstellen, dass Änderungen sofort auftreten und persistent sind

Ein Entwickler kann änderungen an der Routerkonfiguration direkt mithilfe der Routerkonfigurationsfunktionenvornehmen. Änderungen an der Konfiguration werden jedoch erst wirksam, wenn der Router neu gestartet wird, da dies die einzige Zeit ist, in der DIM die Konfiguration aus der Registrierung liest.

Ein Entwickler kann Mithilfe der RouterverwaltungsfunktionenÄnderungen am ausgeführten Router vornehmen. Diese Änderungen sind jedoch nicht persistent: Da sie nicht in die Registrierung geschrieben wurden, gehen sie verloren, wenn der Router neu gestartet wird.

Um Änderungen vorzunehmen, die sowohl unmittelbar als auch dauerhaft sind, muss ein Entwickler sowohl die Routerverwaltung als auch die Routerkonfigurationsfunktionen verwenden. Wenn der Router nicht ausgeführt wird, muss der Entwickler nur die entsprechenden Routerkonfigurationsfunktionen aufrufen.

Verwenden Sie zum Abfragen von Informationen vom ausgeführten Router die Routerverwaltungsfunktionen. Wenn der Router nicht ausgeführt wird, fragen Sie Informationen mithilfe der Routerkonfigurationsfunktionen ab.

Die Funktionen MprAdminInterfaceCreate und MprAdminInterfaceSetInfo unterstützen die MPR _ INTERFACE _ 2-Struktur. MprConfigInterfaceCreate und MprConfigInterfaceSetInfo hingegen nicht. Um eine Nachwahlschnittstelle zu erstellen, die nach einem Neustart persistent ist, rufen Sie MprAdminInterfaceCreate mit MPR _ INTERFACE _ 2 auf, und rufen Sie dann MprConfigInterfaceCreate mit MPR _ INTERFACE _ 0 oder MPR INTERFACE _ _ 1auf. Um persistente Änderungen an einer Schnittstelle für die Wählanforderungen vorzunehmen, rufen Sie MprAdminInterfaceSetInfo mit MPR _ INTERFACE _ 2 auf, und rufen Sie dann MprConfigInterfaceSetInfo mit MPR _ INTERFACE _ 0 oder MPR INTERFACE _ _ 1 auf.

Remote-Verwendung von Routerverwaltungs- und -konfigurationsfunktionen

Die meisten Routerverwaltungs- und Konfigurationsfunktionen können auf einem anderen Computer als dem verwalteten aufgerufen werden. Diese Funktionen akzeptieren als Parameter, ein Handle für den router-Dienst oder die zu verwaltende Konfiguration. Die Verwaltungsfunktionen verwenden RPC (Remote Procedure Call), um mit dem vom Handle angegebenen Routingdienst zu kommunizieren. Die Konfigurationsfunktionen schreiben in die Registrierung des durch das Handle angegebenen Computers und lesen sie aus der Registrierung.

Um den Routingdienst auf einem Remotecomputer zu verwalten, rufen Sie zunächst MprAdminIsServiceRunning auf, um zu überprüfen, ob der Dienst ausgeführt wird. Rufen Sie dann MprAdminServerConnect auf, um das Handle abzurufen. Wenn der Routerdienst nicht auf dem Remotecomputer ausgeführt wird, schlagen alle Aufrufe der Routerverwaltung (MprAdmin) fehl.

Um Änderungen an der Routerkonfiguration auf einem Remotecomputer vorzunehmen, rufen Sie ein Handle ab, indem Sie die MprConfigServerConnect-Funktion aufrufen.