rtmDeleteRouteToDest 函数 (rtmv2.h)

项目
08/25/2023

RtmDeleteRouteToDest 函数从路由表中删除路由，并更新相应目标的最佳路由信息（如果最佳路由发生更改）。如果最佳路由发生更改，则会生成更改通知。

语法

DWORD RtmDeleteRouteToDest(
  [in]  RTM_ENTITY_HANDLE       RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE        RouteHandle,
  [out] PRTM_ROUTE_CHANGE_FLAGS ChangeFlags
);

parameters

[in] RtmRegHandle

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

[in] RouteHandle

要删除的路由的句柄。

[out] ChangeFlags

输入时， ChangeFlags 是指向RTM_ROUTE_CHANGE_FLAGS数据类型的指针。

在输出中，如果更改了最佳路由， ChangeFlags 将收到RTM_ROUTE_CHANGE_BEST标志。

返回值

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

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

值	含义
ERROR_ACCESS_DENIED	调用客户端不拥有此路由。
ERROR_INVALID_HANDLE	该句柄无效。
ERROR_NOT_FOUND	找不到指定的路由。

注解

如果客户端已使用该句柄调用 RtmDeleteRouteToDest，则客户端随后不应释放 RouteHandle。 RtmDeleteRouteToDest 函数删除路由并释放句柄。

要求


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