Función RtmGetNextHopPointer (rtmv2.h)

La función RtmGetNextHopPointer obtiene un puntero directo al próximo salto especificado. El puntero permite al propietario del próximo salto acceso directo de lectura a la estructura de RTM_NEXTHOP_INFO del administrador de tablas de enrutamiento.

Sintaxis

DWORD RtmGetNextHopPointer(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

Parámetros

[in] RtmRegHandle

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] NextHopHandle

Controle el próximo salto.

[out] NextHopPointer

Si el cliente es el propietario del próximo salto, NextHopPointer recibe un puntero al próximo salto.

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_ACCESS_DENIED
 El cliente que realiza la llamada no posee este próximo salto.
ERROR_INVALID_HANDLE
 El identificador no es válido.
 
 

Comentarios

Los clientes solo deben usar este puntero para el acceso de solo lectura.

Cuando el identificador del próximo salto ya no sea necesario, ábralo llamando a RtmReleaseNextHopInfo.

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

RtmFindNextHop

RtmLockNextHop

  • Last updated on