Compartir a través de

Función RtmFindNextHop (rtmv2.h)

  • Artículo

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

Consulte también

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmGetNextHopPointer

RtmLockNextHop