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

Функция RtmGetEnumNextHops извлекает следующий набор следующих прыжков в указанном перечислении.

Синтаксис

DWORD RtmGetEnumNextHops(
  [in]      RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]      RTM_ENUM_HANDLE     EnumHandle,
  [in, out] PUINT               NumNextHops,
  [out]     PRTM_NEXTHOP_HANDLE NextHopHandles
);

Параметры

[in] RtmRegHandle

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

[in] EnumHandle

Обработка перечисления следующего прыжка.

[in, out] NumNextHops

На входных данных NumNextHops — это указатель на значение UINT , указывающее максимальное количество следующих прыжков, которые могут быть получены NextHopHandles.

В выходных данных NumNextHops получает фактическое количество следующих прыжков, полученных NextHopHandles.

[out] NextHopHandles

На входных данных NextHopHandles указывает на структуру RTM_NEXTHOP_INFO .

В выходных данных NextHopHandles получает массив дескрипторов для следующих прыжков.

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Значение, на которое указывает NumRoutes , больше максимального числа маршрутов, которые клиент может получить с помощью одного вызова. Проверьте RTM_REGN_PROFILE максимальное количество следующих прыжков, которое клиент может получить с помощью одного вызова.
ERROR_NO_MORE_ITEMS	Следующие прыжки для перечисления больше не выполняются.

 

 

Комментарии

Когда следующие прыжки больше не требуются, отпустите их, вызвав RtmReleaseNextHops.

Требования

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

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

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops