RtmDeleteNextHop 函数 (rtmv2.h)

RtmDeleteNextHop 函数从下一跃点列表中删除下一跃点。

语法

DWORD RtmDeleteNextHop(
  [in] RTM_ENTITY_HANDLE  RtmRegHandle,
  [in] RTM_NEXTHOP_HANDLE NextHopHandle,
  [in] PRTM_NEXTHOP_INFO  NextHopInfo
);

parameters

[in] RtmRegHandle

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

[in] NextHopHandle

要删除的下一跃点的句柄。 此参数是可选的,可以设置为 NULL;如果为 NULL,则 使用 NextHopInfo 中的值来标识要删除的下一跃点。

[in] NextHopInfo

指向结构的指针,该结构包含标识要删除的下一跃点的信息。 此参数是可选的,可以设置为 NULL;如果为 NULL,则使用 NextHopHandle 中的句柄来标识要删除的下一跃点。

返回值

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

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

含义
ERROR_ACCESS_DENIED
调用客户端不拥有此下一跃点。
ERROR_NOT_ENOUGH_MEMORY
内存不足,无法完成此操作。
ERROR_NOT_FOUND
找不到指定的下一跃点。
 
 

注解

如果客户端指定 NextHopHandle,则客户端随后不应使用 RtmReleaseNextHops 释放句柄。

要求

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

请参阅

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmFindNextHop

RtmGetNextHopPointer