Noções básicas sobre funções de gerenciamento de roteador

As seções a seguir discutem os diferentes tipos de funções de gerenciamento de roteador e o que você deve saber para usá-las com eficiência.

Todas as funções de gerenciamento de roteador exigem privilégios de administrador. Um usuário no grupo do Power User não tem privilégios suficientes para usar as funções de gerenciamento do roteador.

As diferentes classes de funções de gerenciamento de roteador

As funções de gerenciamento do roteador podem ser divididas nas funções de administração e nas funções de configuração. As funções de administração têm um prefixo de MprAdmin e as funções de configuração têm um prefixo de MprConfig. Apesar da nomenclatura, ambos os conjuntos de funções são usados para o gerenciamento de roteador. As funções MprAdmin operam diretamente no roteador em execução. As funções MprConfig têm funcionalidade semelhante, mas operam na configuração do roteador armazenada no registro. Ambos os tipos de funções passam blocos de informações.

As funções de gerenciamento do roteador também podem ser divididas com base em quais componentes do roteador eles gerenciam: interfaces, gerentes de roteador ou clientes do gerenciador de roteadores.

As funções de interface do roteador têm um prefixo de MprAdminInterface ou MprConfigInterface. Use essas funções para acessar interfaces. As funções do gerenciador de roteador têm um prefixo de MprAdminTransport ou MprConfigTransport. Use essas funções para acessar os gerentes de roteador. Por fim, as funções de cliente do gerenciador de roteador têm um prefixo de MprAdminInterfaceTransport ou MprConfigInterfaceTransport. Use essas funções para acessar os clientes em execução no roteador.

Um subconjunto de funções MprAdmin são as funções MprAdminMib. Eles também operam apenas na rota em execução. No entanto, essas funções não passam blocos de informações. Essas funções fornecem flexibilidade adicional ao designer de protocolo, especialmente para recuperar informações de não configuração, como estatísticas.

Garantir que as alterações ocorram imediatamente e sejam persistentes

Um desenvolvedor pode fazer alterações na configuração do roteador diretamente usando as funções de configuração do roteador. No entanto, as alterações feitas na configuração não entrarão em vigor até que o roteador seja reiniciado, pois esta é a única vez em que o DIM lê a configuração do registro.

Um desenvolvedor pode fazer alterações no roteador em execução usando as funções de administração do roteador. No entanto, essas alterações não são persistentes: como não foram gravadas no registro, elas serão perdidas se o roteador for reiniciado.

Para fazer alterações imediatas e persistentes, um desenvolvedor precisa usar a administração do roteador e as funções de configuração do roteador. Se o roteador não estiver em execução, o desenvolvedor precisará chamar apenas as funções de configuração de roteador apropriadas.

Para consultar informações do roteador em execução, use as funções de administração do roteador. Se o roteador não estiver em execução, consulte as informações usando as funções de configuração do roteador.

As funções MprAdminInterfaceCreate e MprAdminInterfaceSetInfo dão suporte à estrutura MPR_INTERFACE_2 . No entanto, MprConfigInterfaceCreate e MprConfigInterfaceSetInfo não. Para criar uma interface de discagem de demanda persistente após uma reinicialização, chame MprAdminInterfaceCreate com MPR_INTERFACE_2 e chame MprConfigInterfaceCreate com MPR_INTERFACE_0 ou MPR_INTERFACE_1. Da mesma forma, para fazer alterações persistentes em uma interface de discagem de demanda, chame MprAdminInterfaceSetInfo com MPR_INTERFACE_2 e chame MprConfigInterfaceSetInfo com MPR_INTERFACE_0 ou MPR_INTERFACE_1.

Usando funções de administração e configuração do roteador remotamente

A maioria das funções de administração e configuração do roteador pode ser chamada em um computador diferente do que está sendo administrado. Essas funções assumem como um parâmetro, um identificador para o serviço de roteador ou configuração a ser administrado. As funções de administração usam RPC (Chamada de Procedimento Remoto) para se comunicar com o serviço de roteamento especificado pelo identificador. As funções de configuração gravam e leem do registro do computador especificado pelo identificador.

Para administrar o serviço de roteamento em um computador remoto, primeiro chame MprAdminIsServiceRunning para verificar se o serviço está em execução. Em seguida, chame MprAdminServerConnect para obter o identificador. Se o serviço de roteador não estiver em execução no computador remoto, todas as chamadas de administração de roteador (MprAdmin) falharão.

Para fazer alterações na configuração do roteador em um computador remoto, obtenha um identificador chamando a função MprConfigServerConnect .