RtmEnumerateGetNextRoute 函数

[此 API 已被 路由表管理器版本 2 API 取代，在 Windows Server 2003 之后不可用。 应用程序应使用路由表管理器版本 2 API。]

RtmEnumerateGetNextRoute 函数返回通过调用 RtmCreateEnumerationHandle 启动的枚举中的下一路由条目。

语法

DWORD RtmEnumerateGetNextRoute(
  _In_  HANDLE EnumerationHandle,
  _Out_ PVOID  Route
);

parameters

EnumerationHandle [in]

标识枚举并指定其范围的句柄。 通过调用 RtmCreateEnumerationHandle 获取此句柄。

路由 [out]

指向特定于协议系列的路由结构的指针 ( RTM_IP_ROUTE 或 RTM_IPX_ROUTE) 。 此结构将接收枚举中的下一个路由。

返回值

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

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

值	说明
ERROR_INVALID_HANDLE	EnumerationHandle 参数无效。
ERROR_NO_MORE_ROUTES	枚举中没有更多路由。
ERROR_NO_SYSTEM_RESOURCES	资源不足，无法执行该操作。

备注

尽管路由不会按任何特定顺序返回，但枚举中的每个路由仅返回一次。

要求

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

另请参阅

路由表管理器版本 1 参考

路由表管理器版本 1 函数

RTM_IP_ROUTE

RTM_IPX_ROUTE

RtmCloseEnumerationHandle

RtmCreateEnumerationHandle