Função RtmDeleteRouteToDest (rtmv2.h)
A função RtmDeleteRouteToDest exclui uma rota da tabela de roteamento e atualiza as informações de melhor rota para o destino correspondente, se a melhor rota for alterada. Se a melhor rota for alterada, uma notificação de alteração será gerada.
Sintaxe
DWORD RtmDeleteRouteToDest(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ROUTE_HANDLE RouteHandle,
[out] PRTM_ROUTE_CHANGE_FLAGS ChangeFlags
);
Parâmetros
[in] RtmRegHandle
Manipule para o cliente obtido de uma chamada anterior para RtmRegisterEntity.
[in] RouteHandle
Manipule para a rota a ser excluída.
[out] ChangeFlags
Na entrada, ChangeFlags é um ponteiro para RTM_ROUTE_CHANGE_FLAGS tipo de dados.
Na saída, ChangeFlags receberá RTM_ROUTE_CHANGE_BEST sinalizador se a melhor rota tiver sido alterada.
Valor retornado
Se a função for bem-sucedida, o valor retornado será NO_ERROR.
Se a função falhar, o valor retornado será um dos seguintes códigos de erro.
| Valor | Significado |
|---|---|
|
O cliente de chamada não possui essa rota. |
|
O manipulador é inválido. |
|
A rota especificada não foi encontrada. |
Comentários
O RouteHandle não deverá ser lançado posteriormente por um cliente se o cliente já tiver chamado RtmDeleteRouteToDest usando esse identificador. A função RtmDeleteRouteToDest exclui a rota e libera o identificador.
Requisitos
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | rtmv2.h |
| Biblioteca | Rtm.lib |
| DLL | Rtm.dll |