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

另请参阅

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops