Función RtmIsRoute

[Esta API se ha reemplazado por la API del Administrador de tablas de enrutamiento versión 2 y no estará disponible más allá de Windows Server 2003. Las aplicaciones deben usar la API routing Table Manager versión 2.

La función RtmIsRoute determina si existe una o varias rutas a una red de destino especificada. Si es así, la función devuelve información para obtener la mejor ruta a esa red.

Sintaxis

BOOL RtmIsRoute(
  _In_  DWORD ProtocolFamily,
  _In_  PVOID Network,
  _Out_ PVOID BestRoute
);

Parámetros

ProtocolFamily [in]

Especifica el tipo de estructura de datos a la que apunta el parámetro Network , por ejemplo, IP_NETWORK, IPX_NETWORK.

Red [in]

Puntero a una estructura que especifica los datos de número de red específicos de la familia de protocolos. Estos datos identifican la red para la que el autor de la llamada busca información de ruta.

BestRoute [out]

Puntero a una estructura específica de la familia de protocolos que recibe la mejor información de ruta actual, si existe.

Valor devuelto

El valor devuelto es uno de los códigos siguientes.

Value Descripción
TRUE
Existe al menos una ruta a la red especificada. La mejor ruta se devuelve en la estructura a la que apunta el parámetro BestRoute .
FALSE
No hay ninguna ruta a la red especificada o se produjo un error en la operación. Llame a GetLastError para obtener más información:
NO_ERROR
La operación se realizó correctamente, pero no hay ninguna ruta a la red especificada.
ERROR_INVALID_PARAMETER
El valor del parámetro ProtocolFamily no corresponde a ninguna familia de protocolos instalada.
ERROR_NO_SYSTEM_RESOURCES
No hay recursos suficientes para llevar a cabo la operación.

Requisitos

Requisito Value
Cliente mínimo compatible
No se admite ninguno
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Fin de compatibilidad de servidor
Windows Server 2003
Encabezado
Rtm.h
Biblioteca
Rtm.lib
Archivo DLL
Rtm.dll

Consulte también

Referencia de la versión 1 del Administrador de tablas de enrutamiento

Funciones del Administrador de tablas de enrutamiento versión 1

GetLastError

IP_NETWORK

IPX_NETWORK

Identificadores de familia de protocolo RTMv1