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。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_ACCESS_DENIED
 调用客户端不拥有此下一跃点。
ERROR_NOT_FOUND
 找不到指定的下一跃点。
 
 

注解

只要客户端尚未发布 NextHopHandle，NextHopPointer 就有效。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 rtmv2.h
Library Rtm.lib
DLL Rtm.dll

另请参阅

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmGetNextHopPointer

RtmLockNextHop