Registrieren beim Routingtabellen-Manager

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

Wenn sich ein Client registriert, übergibt er eine RTM_ENTITY_INFO-Struktur an den Routingtabellen-Manager. Diese Struktur enthält die Informationen, die einen Client eindeutig identifizieren, die Adressfamilie und die instance des Routingtabellen-Managers, bei dem der Client registriert wird. Ein Client kann auch den RTM_EVENT_CALLBACK Rückruf 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 rtmRegisterEntity-Funktion , die in RTMv2 verwendet wird, entspricht der RtmRegisterClient-Funktion , die in RTMv1 verwendet wird. Die RtmRegisterClient-Funktion ist veraltet, mit Ausnahme von Clients, die IPX verwenden.

Nachdem ein Client die Interaktion mit dem Routingtabellen-Manager beendet hat, muss er RtmDeregisterEntity aufrufen. Der Routingtabellen-Manager zerstört das Handle, das dem Client zugeordnet ist. 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 RtmDeregisterEntity aufgerufen wird.

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