通过

RtmInsertInRouteList 函数 (rtmv2.h)

  • 项目

RtmInsertInRouteList 函数将指定的路由集插入客户端的路由列表中。 如果某个路由已位于另一个列表中，则会从旧列表中删除该路由并插入到新列表中。

语法

DWORD RtmInsertInRouteList(
  [in] RTM_ENTITY_HANDLE     RtmRegHandle,
  [in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [in] UINT                  NumRoutes,
  [in] PRTM_ROUTE_HANDLE     RouteHandles
);

参数

[in] RtmRegHandle

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

[in] RouteListHandle

要向其添加路由的路由列表的句柄。 指定 NULL 以从其旧列表中删除指定的路由。

[in] NumRoutes

指定 RouteHandles 中的路由数。

[in] RouteHandles

指向要从旧列表移动到新列表的路由句柄数组的指针。

返回值

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

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

值 含义
ERROR_INVALID_HANDLE
 该句柄无效。

注解

如果不再需要路由，请通过调用 RtmReleaseRoutes 来释放这些路由。

有关使用此函数的示例代码，请参阅 使用 Client-Specific 路由列表。

要求

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

另请参阅

RtmCreateRouteList

RtmDeleteRouteList