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 |
|---|---|
|
El cliente que realiza la llamada no posee este próximo salto. |
|
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 |