RtmGetNextHopPointer 函数 (rtmv2.h)

RtmGetNextHopPointer 函数获取指向指定下一跃点的直接指针。 指针允许下一跃点所有者直接读取路由表管理器的 RTM_NEXTHOP_INFO 结构。

语法

DWORD RtmGetNextHopPointer(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

参数

[in] RtmRegHandle

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

[in] NextHopHandle

下一跃点的句柄。

[out] NextHopPointer

如果客户端是下一跃点的所有者, NextHopPointer 将收到指向下一跃点的指针。

返回值

如果函数成功,则返回值NO_ERROR。

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

含义
ERROR_ACCESS_DENIED
调用客户端不拥有此下一跃点。
ERROR_INVALID_HANDLE
该句柄无效。
 
 

注解

客户端应仅将此指针用于只读访问。

不再需要下一跃点句柄时,请通过调用 RtmReleaseNextHopInfo 将其释放。

要求

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

另请参阅

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmFindNextHop

RtmLockNextHop