Registrieren beim Routingtabellen-Manager

Bevor ein Client auf die Routingtabelle zugreifen kann, muss er sich zunächst mithilfe der RtmRegisterEntity-Funktion beim Routingtabellen-Manager registrieren.

Wenn ein Client registriert wird, übergibt er eine RTM _ ENTITY _ INFO-Struktur an den Routingtabellen-Manager. Diese Struktur enthält die Informationen, die einen Client, die Adressfamilie und die Instanz des Routingtabellen-Managers eindeutig identifizieren, bei dem der Client registriert wird. Ein Client kann auch den RÜCKRUF FÜR _ _ RTM-EREIGNISSE einrichten. Der Routingtabellen-Manager verwendet diesen Rückruf, um den Client über Ereignisse wie Änderungsbenachrichtigungen und Clientregistrierungen zu benachrichtigen.

Der Routingtabellen-Manager schließt die Registrierungsverarbeitung ab und gibt ein Handle an den Client zurück. Der Client muss dieses Handle für alle nachfolgenden Aufrufe von RTMv2-Funktionen verwenden.

Die in RTMv2 verwendete RtmRegisterEntity-Funktion entspricht der RtmRegisterClient-Funktion, die in RTMv1 verwendet wird. Die RtmRegisterClient-Funktion ist veraltet, mit Ausnahme von Clients, die IPX verwenden.

Sobald ein Client die Interaktion mit dem Routingtabellen-Manager abgeschlossen hat, muss er RtmDeregisterEntityaufrufen. Der Routingtabellen-Manager zerstört das dem Client zugeordnete Handle. Um Speicherverluste zu vermeiden, muss der Client sicherstellen, dass er alle Handles freigibt und alle Routen und nächsten Hops löscht, die er besitzt, bevor er RtmDeregisterEntity aufruft.

Beispielcode zur Verwendung dieser Funktionen finden Sie unter Registrieren beim Routingtabellen-Manager und Verwenden des Ereignisbenachrichtigungsrückrufs.