Función RtmGetExactMatchDestination (rtmv2.h)

Artículo
03/15/2023

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
ERROR_NOT_FOUND	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