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

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

  • Статья

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

Синтаксис

DWORD RtmCreateNextHopEnum(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ENUM_FLAGS    EnumFlags,
  [in]  PRTM_NET_ADDRESS  NetAddress,
  [out] PRTM_ENUM_HANDLE  RtmEnumHandle
);

Параметры

[in] RtmRegHandle

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

[in] EnumFlags

Указывает, какие следующие прыжки следует включить в перечисление . Используются следующие флаги.

Константа Значение
RTM_ENUM_NEXT
 Перечисление следующих прыжков, начиная с указанной длины адреса или маски (например, 10/8). Перечисление продолжается до конца списка следующего прыжка.
RTM_ENUM_RANGE
 Перечисление следующих прыжков в указанном диапазоне, заданном длиной адреса или маски (например, 10/8).
RTM_ENUM_START
 Перечисление следующих прыжков, начиная с 0/0. Укажите ЗНАЧЕНИЕ NULL для NetAddress.

[in] NetAddress

Указатель на структуру RTM_NET_ADDRESS , содержащую начальный адрес перечисления. Укажите ЗНАЧЕНИЕ NULL , если EnumFlags содержит RTM_ENUM_START.

[out] RtmEnumHandle

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

В выходных данных RtmEnumHandle получает указатель на дескриптор перечисления . Используйте этот дескриптор во всех последующих вызовах RtmGetEnumNextHops, RtmReleaseNextHops и RtmDeleteEnumHandle.

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

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

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

Значение Значение
ERROR_INVALID_PARAMETER
 Параметр содержит неверные сведения.
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно памяти для выполнения этой операции.
 
 

Комментарии

Если EnumFlags содержит RTM_ENUM_RANGE, используйте NetAddress , чтобы указать диапазон таблицы маршрутизации для перечисления. Например, если клиент устанавливает для NetAddress значение 10/8, возвращаются следующие прыжки в диапазоне от 10.0.0.0/8 до 10.255.255.255/32.

Если дескриптор перечисления больше не требуется, отпустите его, вызвав RtmDeleteEnumHandle.

Требования

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

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

RTM_NET_ADDRESS

RtmDeleteEnumHandle

RtmGetEnumNextHops

RtmReleaseNextHops