rtmDeleteRouteToDest 函数 (rtmv2.h)
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。
如果函数失败,则返回值为以下错误代码之一。
值 | 含义 |
---|---|
|
调用客户端不拥有此路由。 |
|
该句柄无效。 |
|
找不到指定的路由。 |
注解
如果客户端已使用该句柄调用 RtmDeleteRouteToDest,则客户端随后不应释放 RouteHandle。 RtmDeleteRouteToDest 函数删除路由并释放句柄。
要求
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | rtmv2.h |
Library | Rtm.lib |
DLL | Rtm.dll |