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

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

  • Статья

Функция RtmFindNextHop находит конкретный следующий прыжок в списке следующего прыжка клиента.

Синтаксис

DWORD RtmFindNextHop(
  [in]  RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]  PRTM_NEXTHOP_INFO   NextHopInfo,
  [out] PRTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO   *NextHopPointer
);

Параметры

[in] RtmRegHandle

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

[in] NextHopInfo

Указатель на структуру RTM_NEXTHOP_INFO , содержащую сведения, определяющие следующий прыжок для поиска. Используйте элементы NextHopAddress и InterfaceIndex , чтобы определить следующий прыжок для поиска.

[out] NextHopHandle

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

Если дескриптор не требуется возвращать: при входных данных NextHopPointer имеет значение NULL.

[out] NextHopPointer

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

Если указатель не требуется возвращать: при входных данных NextHopPointer имеет значение NULL.

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

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

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

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

Комментарии

NextHopPointer действителен до тех пор, пока клиент не выпустил NextHopHandle.

Требования

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

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

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmGetNextHopPointer

RtmLockNextHop