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。
如果函数失败，则返回值为以下错误代码之一。
| 值 | 含义 |
|---|---|
|
调用客户端不拥有此下一跃点。 |
|
找不到指定的下一跃点。 |
注解
只要客户端尚未发布 NextHopHandle，NextHopPointer 就有效。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | rtmv2.h |
| Library | Rtm.lib |
| DLL | Rtm.dll |