Función RtmEnumerateGetNextRoute

[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 RtmEnumerateGetNextRoute devuelve la entrada de ruta siguiente en la enumeración iniciada por una llamada a RtmCreateEnumerationHandle.

Sintaxis

DWORD RtmEnumerateGetNextRoute(
  _In_  HANDLE EnumerationHandle,
  _Out_ PVOID  Route
);

Parámetros

EnumerationHandle [in]

Identificador que identifica la enumeración y especifica su ámbito. Obtenga este identificador llamando a RtmCreateEnumerationHandle.

Ruta [salida]

Puntero a una estructura de ruta específica de la familia de protocolos ( RTM_IP_ROUTE o RTM_IPX_ROUTE). Esta estructura recibirá la siguiente ruta en la enumeración.

Valor devuelto

Si la función se ejecuta 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.

Comentarios

Aunque las rutas no se devuelven en ningún orden determinado, cada ruta de la enumeración solo se devuelve una vez.

Requisitos

Consulte también

Referencia del Administrador de tablas de enrutamiento versión 1

Funciones del Administrador de tablas de enrutamiento versión 1

RTM_IP_ROUTE

RTM_IPX_ROUTE

RtmCloseEnumerationHandle

RtmCreateEnumerationHandle