通过

rtmCreateRouteListEnum 函数 (rtmv2.h)

  • 项目

RtmCreateRouteListEnum 函数在指定的路由列表中创建路由的枚举。

语法

DWORD RtmCreateRouteListEnum(
  [in]  RTM_ENTITY_HANDLE     RtmRegHandle,
  [in]  RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [out] PRTM_ENUM_HANDLE      RtmEnumHandle
);

参数

[in] RtmRegHandle

从先前调用 RtmRegisterEntity 获取的客户端的句柄。

[in] RouteListHandle

要枚举的路由列表的句柄，该路由列表是从上一次调用 RtmCreateRouteList 获取的。

[out] RtmEnumHandle

输入时， RtmEnumHandle 是指向 NULL 的指针。

输出时， RtmEnumHandle 接收指向枚举句柄的指针。 在对枚举路由列表的函数的所有后续调用中使用此句柄。

返回值

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

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

值 含义
ERROR_NOT_ENOUGH_MEMORY
 内存不足，无法完成此操作。
 
 

注解

如果不再需要枚举句柄，请通过调用 RtmDeleteEnumHandle 释放它。

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

要求

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

另请参阅

RtmDeleteEnumHandle

RtmGetListEnumRoutes