Função RtmGetExactMatchDestination (rtmv2.h)
A função RtmGetExactMatchDestination pesquisa na tabela de roteamento um destino que corresponda exatamente ao endereço de rede e à máscara de sub-rede especificados. Se uma correspondência exata for encontrada, as informações desse destino serão retornadas.
Sintaxe
DWORD RtmGetExactMatchDestination(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] PRTM_NET_ADDRESS DestAddress,
[in] ULONG ProtocolId,
[in] RTM_VIEW_SET TargetViews,
[out] PRTM_DEST_INFO DestInfo
);
Parâmetros
[in] RtmRegHandle
Identificador para o cliente obtido de uma chamada anterior para RtmRegisterEntity.
[in] DestAddress
Ponteiro para o endereço de rede de destino.
[in] ProtocolId
Especifica o identificador de protocolo. O ProtocolID não faz parte dos critérios de pesquisa. O gerenciador de tabelas de roteamento usa esse identificador para determinar quais informações de destino e rota devem ser retornadas. Por exemplo, se um cliente especificar o identificador de protocolo RIP, a melhor rota RIP será retornada, mesmo que uma rota não RIP seja a melhor rota para o destino.
Especifique RTM_BEST_PROTOCOL para retornar uma rota, independentemente de qual protocolo a possua. Especifique RTM_THIS_PROTOCOL para retornar a melhor rota para o protocolo de chamada.
[in] TargetViews
Especifica os modos de exibição dos quais as informações serão retornadas. Se o cliente especificar RTM_VIEW_MASK_ANY, as informações de destino serão retornadas de todas as exibições; no entanto, nenhuma informação específica da exibição é retornada.
[out] DestInfo
Na entrada, DestInfo é um ponteiro para uma estrutura RTM_DEST_INFO .
Na saída, DestInfo é preenchido com as informações de destino solicitadas.
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 códigos de erro a seguir.
| Valor | Significado |
|---|---|
|
O destino especificado não foi encontrado. |
Comentários
A estrutura DestInfo é uma estrutura de tamanho variável. Se o cliente especificar mais de uma exibição com TargetViews, o tamanho de DestInfo aumentará para cada exibição. Use a macro RTM_SIZE_OF_DEST_INFO para determinar o tamanho de uma estrutura DestInfo a ser alocada antes de chamar essa função. Use o valor especificado para TargetViews como um parâmetro para RTM_SIZE_OF_DEST_INFO.
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 |