Registrando com o Gerenciador de Tabelas de Roteamento

Antes que um cliente possa acessar a tabela de roteamento, primeiro ele deve se registrar no gerenciador de tabelas de roteamento usando a função RtmRegisterEntity .

Quando um cliente é registrado, ele passa para o gerenciador de tabelas de roteamento uma estrutura RTM_ENTITY_INFO . Essa estrutura contém as informações que identificam exclusivamente um cliente, a família de endereços e a instância do gerenciador de tabelas de roteamento com o qual o cliente está se registrando. Um cliente também pode estabelecer o retorno de chamada RTM_EVENT_CALLBACK. O gerenciador de tabelas de roteamento usará esse retorno de chamada para notificar o cliente de eventos como notificações de alteração e registros de cliente.

O gerenciador de tabelas de roteamento conclui seu processamento de registro e retorna um identificador para o cliente. O cliente deve usar esse identificador para todas as chamadas subsequentes para funções RTMv2.

A função RtmRegisterEntity usada no RTMv2 é análoga à função RtmRegisterClient usada no RTMv1. A função RtmRegisterClient está obsoleta, exceto para clientes que usam IPX.

Depois que um cliente terminar de interagir com o gerenciador de tabelas de roteamento, ele deverá chamar RtmDeregisterEntity. O gerenciador de tabelas de roteamento destrói o identificador associado ao cliente. Para evitar vazamentos de memória, o cliente deve garantir que ele libere todos os identificadores e exclua todas as rotas e próximos saltos que possui antes de chamar RtmDeregisterEntity.

Para obter um código de exemplo que mostra como usar essas funções, consulte Registrar com o Gerenciador de Tabelas de Roteamento e Usar o retorno de chamada de notificação de evento.