Informazioni sulle funzioni di gestione dei router

Le sezioni seguenti illustrano i diversi tipi di funzioni di gestione del router e ciò che è necessario sapere per usarli in modo efficace.

Tutte le funzioni di gestione del router richiedono privilegi di amministratore. Un utente nel gruppo Power User non dispone di privilegi sufficienti per usare le funzioni di gestione del router.

Classi diverse di funzioni di gestione router

Le funzioni di gestione del router possono essere suddivise nelle funzioni di amministrazione e nelle funzioni di configurazione. Le funzioni di amministrazione hanno un prefisso di MprAdmin e le funzioni di configurazione hanno un prefisso di MprConfig. Nonostante la denominazione, entrambi i set di funzioni vengono usati per la gestione del router. Le funzioni MprAdmin operano direttamente nel router in esecuzione. Le funzioni MprConfig hanno funzionalità simili, ma operano sulla configurazione del router archiviata nel Registro di sistema. Entrambi i tipi di funzioni passano blocchi di informazioni.

Le funzioni di gestione del router possono anche essere suddivise in base ai componenti del router gestiti: interfacce, gestioni router o client di gestione router.

Le funzioni dell'interfaccia del router hanno un prefisso di MprAdminInterface o MprConfigInterface. Usare queste funzioni per accedere alle interfacce. Le funzioni di gestione router hanno un prefisso di MprAdminTransport o MprConfigTransport. Usare queste funzioni per accedere alle gestioni router. Infine, le funzioni client di gestione router hanno un prefisso di MprAdminInterfaceTransport o MprConfigInterfaceTransport. Usare queste funzioni per accedere ai client in esecuzione nel router.

Un subset di funzioni MprAdmin sono le funzioni MprAdminMib. Queste operazioni operano anche sulla route in esecuzione da soli. Tuttavia, queste funzioni non passano blocchi di informazioni. Queste funzioni offrono flessibilità aggiuntiva alla finestra di progettazione protocolli, in particolare per il recupero di informazioni non di configurazione, ad esempio statistiche.

Assicurarsi che le modifiche si verifichino immediatamente e siano persistenti

Uno sviluppatore può apportare modifiche alla configurazione del router direttamente usando le funzioni di configurazione del router. Tuttavia, tutte le modifiche apportate alla configurazione non vengono applicate finché il router non viene riavviato, poiché si tratta dell'unica volta che DIM legge la configurazione dal Registro di sistema.

Uno sviluppatore può apportare modifiche al router in esecuzione usando le funzioni di amministrazione del router. Tuttavia, queste modifiche non sono persistenti: poiché non sono state scritte nel Registro di sistema, vengono perse se il router viene riavviato.

Per apportare modifiche sia immediate che persistenti, uno sviluppatore deve usare sia l'amministrazione del router che le funzioni di configurazione del router. Se il router non è in esecuzione, lo sviluppatore deve chiamare solo le funzioni di configurazione del router appropriate.

Per eseguire query sulle informazioni dal router in esecuzione, usare le funzioni di amministrazione del router. Se il router non è in esecuzione, eseguire query sulle informazioni usando le funzioni di configurazione del router.

Le funzioni MprAdminInterfaceCreate e MprAdminInterfaceSetInfosupportano la struttura di MPR_INTERFACE_2 . Tuttavia, MprConfigInterfaceCreate e MprConfigInterfaceSetInfo non fanno. Per creare un'interfaccia di chiamata a richiesta persistente dopo un riavvio, chiamare MprAdminInterfaceCreate con MPR_INTERFACE_2, quindi chiamare MprConfigInterfaceCreate con MPR_INTERFACE_0 o MPR_INTERFACE_1. Analogamente, per apportare modifiche persistenti a un'interfaccia di chiamata a richiesta, chiamare MprAdminInterfaceSetInfo con MPR_INTERFACE_2, quindi chiamare MprConfigInterfaceSetInfo con MPR_INTERFACE_0 o MPR_INTERFACE_1.

Uso di amministrazione del router e funzioni di configurazione in remoto

La maggior parte delle funzioni di amministrazione e configurazione del router può essere chiamata in un computer diverso da quello amministrato. Queste funzioni accettano come parametro un handle per il servizio router o la configurazione da amministrare. Le funzioni di amministrazione usano RPC (Remote Procedure Call) per comunicare con il servizio di routing specificato dall'handle. Le funzioni di configurazione scrivono e leggono dal Registro di sistema del computer specificato dall'handle.

Per amministrare il servizio di routing in un computer remoto chiamare prima MprAdminIsServiceRunning per verificare che il servizio sia in esecuzione. Chiamare quindi MprAdminServerConnect per ottenere l'handle. Se il servizio router non è in esecuzione nel computer remoto, tutte le chiamate di amministrazione del router (MprAdmin) non riescono.

Per apportare modifiche alla configurazione del router in un computer remoto, ottenere un handle chiamando la funzione MprConfigServerConnect .