Función RtmLockNextHop (rtmv2.h)
La función RtmLockNextHop bloquea o desbloquea un próximo salto. El propietario del próximo salto debe llamar a esta función para bloquear el próximo salto antes de realizar cambios en el próximo salto. Se devuelve un puntero al próximo salto.
Sintaxis
DWORD RtmLockNextHop(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NEXTHOP_HANDLE NextHopHandle,
[in] BOOL Exclusive,
[in] BOOL LockNextHop,
[out] PRTM_NEXTHOP_INFO *NextHopPointer
);
Parámetros
[in] RtmRegHandle
Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.
[in] NextHopHandle
Controla el próximo salto para bloquear o desbloquear.
[in] Exclusive
Especifica si se debe bloquear o desbloquear el próximo salto en un modo exclusivo (TRUE) o compartido (FALSE).
[in] LockNextHop
Especifica si se va a bloquear o desbloquear el próximo salto. Especifique TRUE para bloquear el próximo salto; especifique FALSE para desbloquearlo.
[out] NextHopPointer
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.
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. |
|
No se encontró el próximo salto especificado. |
Comentarios
Los clientes no pueden cambiar los miembros NextHopAddress e InterfaceIndex de la estructura RTM_NEXTHOP_INFO ; estos valores se usan para identificar de forma única un próximo salto.
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 |