通过

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
);

parameters

[in] RtmRegHandle

从上一次调用 RtmRegisterEntity 获取的客户端的句柄。

[in] EnumFlags

指定要包含在枚举中的下一跃点。 使用以下标志。

返回的常量 含义
RTM_ENUM_NEXT
 枚举从指定地址/掩码长度 (（例如 10/8) ）开始的下一跃点。 枚举一直持续到下一跃点列表的末尾。
RTM_ENUM_RANGE
 枚举地址/掩码长度 (指定的指定范围内的下一跃点，例如 10/8) 。
RTM_ENUM_START
 枚举从 0/0 开始的下一跃点。 为 NetAddress 指定 NULL。

[in] NetAddress

指向包含枚举起始地址 的RTM_NET_ADDRESS 结构的指针。 如果 EnumFlags 包含RTM_ENUM_START，则指定 NULL。

[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
标头 rtmv2.h
Library Rtm.lib
DLL Rtm.dll

请参阅

RTM_NET_ADDRESS

RtmDeleteEnumHandle

RtmGetEnumNextHops

RtmReleaseNextHops