Función RtmFindNextHop (rtmv2.h)

Artículo
08/25/2023

La función RtmFindNextHop busca un próximo salto específico en la lista de próximo salto de un cliente.

Sintaxis

DWORD RtmFindNextHop(
  [in]  RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]  PRTM_NEXTHOP_INFO   NextHopInfo,
  [out] PRTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO   *NextHopPointer
);

Parámetros

[in] RtmRegHandle

Identificador para el cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] NextHopInfo

Puntero a una estructura de RTM_NEXTHOP_INFO que contiene información que identifica el próximo salto que se va a buscar. Use los miembros NextHopAddress e InterfaceIndex para identificar el próximo salto que se va a buscar.

[out] NextHopHandle

Si se debe devolver un identificador: en la entrada, NextHopPointer es un puntero a NULL. En la salida, si el cliente posee el próximo salto, NextHopPointer recibe un puntero al identificador del próximo salto; de lo contrario, NextHopPointer permanece sin cambios.

Si no es necesario devolver un identificador: en la entrada, NextHopPointer es NULL.

[out] NextHopPointer

Si se debe devolver un puntero: En la entrada, NextHopPointer es un puntero a NULL. En la salida, si el cliente posee el próximo salto, NextHopPointer recibe un puntero al próximo salto; de lo contrario, NextHopPointer permanece sin cambios.

Si no es necesario devolver un puntero: en la entrada, NextHopPointer es NULL.

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.

Valor	Significado
ERROR_ACCESS_DENIED	El cliente que realiza la llamada no posee este próximo salto.
ERROR_NOT_FOUND	No se encontró el próximo salto especificado.

Comentarios

NextHopPointer es válido siempre que el cliente no haya publicado NextHopHandle.

Requisitos

Requisito	Value
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