Поделиться через

Функция RtmLockNextHop (rtmv2.h)

  • Статья

Функция RtmLockNextHop блокирует или разблокирует следующий прыжок. Эта функция должна вызываться владельцем следующего прыжка, чтобы заблокировать следующий прыжок перед внесением изменений в следующий прыжок. Возвращается указатель на следующий прыжок.

Синтаксис

DWORD RtmLockNextHop(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [in]  BOOL               Exclusive,
  [in]  BOOL               LockNextHop,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

Параметры

[in] RtmRegHandle

Дескриптор клиента, полученного из предыдущего вызова RtmRegisterEntity.

[in] NextHopHandle

Дескриптор до следующего прыжка для блокировки или разблокировки.

[in] Exclusive

Указывает, следует ли заблокировать или разблокировать следующий прыжок в монопольном режиме (TRUE) или общем режиме (FALSE).

[in] LockNextHop

Указывает, следует ли заблокировать или разблокировать следующий прыжок. Укажите ЗНАЧЕНИЕ TRUE , чтобы заблокировать следующий прыжок; укажите ЗНАЧЕНИЕ FALSE , чтобы разблокировать его.

[out] NextHopPointer

На входных данных NextHopPointer является указателем на NULL.

В выходных данных, если клиенту принадлежит следующий прыжок, NextHopPointer получает указатель на следующий прыжок; в противном случае NextHopPointer остается без изменений.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.

Значение Значение
ERROR_ACCESS_DENIED
 Вызывающий клиент не владеет этим следующим прыжком.
ERROR_NOT_FOUND
 Указанный следующий прыжок не найден.
 
 

Комментарии

Клиенты не могут изменять элементы NextHopAddress и InterfaceIndexструктуры RTM_NEXTHOP_INFO ; Эти значения используются для уникальной идентификации следующего прыжка.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header rtmv2.h
Библиотека Rtm.lib
DLL Rtm.dll

См. также раздел

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmFindNextHop

RtmGetNextHopPointer