Función RtmGetExactMatchDestination (rtmv2.h)
La función RtmGetExactMatchDestination busca en la tabla de enrutamiento un destino que coincida exactamente con la dirección de red y la máscara de subred especificadas. Si se encuentra una coincidencia exacta, se devuelve la información de ese destino.
Sintaxis
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 del cliente obtenido de una llamada anterior a RtmRegisterEntity.
[in] DestAddress
Puntero a la dirección de red de destino.
[in] ProtocolId
Especifica el identificador de protocolo. ProtocolID no forma parte de los criterios de búsqueda. El administrador de tablas de enrutamiento usa este identificador para determinar qué información de destino y ruta se va a devolver. Por ejemplo, si un cliente especifica el identificador del protocolo RIP, se devuelve la mejor ruta RIP, aunque una ruta que no sea RIP sea la mejor ruta al destino.
Especifique RTM_BEST_PROTOCOL para devolver una ruta independientemente del protocolo que posee. Especifique RTM_THIS_PROTOCOL para devolver la mejor ruta para el protocolo de llamada.
[in] TargetViews
Especifica las vistas de las que se va a devolver información. Si el cliente especifica RTM_VIEW_MASK_ANY, la información de destino se devuelve de todas las vistas; sin embargo, no se devuelve información específica de la vista.
[out] DestInfo
En la entrada, DestInfo es un puntero a una estructura de RTM_DEST_INFO .
En la salida, DestInfo se rellena con la información de destino solicitada.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
No se encontró el destino especificado. |
Comentarios
La estructura DestInfo es una estructura de tamaño variable. Si el cliente especifica más de una vista con TargetViews, el tamaño de DestInfo aumenta para cada vista. Use la macro RTM_SIZE_OF_DEST_INFO para determinar el tamaño de una estructura DestInfo que se va a asignar antes de llamar a esta función. Use el valor especificado para TargetViews como parámetro para RTM_SIZE_OF_DEST_INFO.
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | rtmv2.h |
| Library | Rtm.lib |
| Archivo DLL | Rtm.dll |