Share via

rtmGetRouteInfo 函数 (rtmv2.h)

  • 项目

RtmGetRouteInfo 函数返回指定路由的信息。

语法

DWORD RtmGetRouteInfo(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE  RouteHandle,
  [out] PRTM_ROUTE_INFO   RouteInfo,
  [out] PRTM_NET_ADDRESS  DestAddress
);

参数

[in] RtmRegHandle

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

[in] RouteHandle

要查找的路由的句柄。

[out] RouteInfo

如果必须返回指针：输入时， RouteInfo 是指向 NULL 的指针。 输出时， RouteInfo 接收指向路由的指针;否则， RouteInfo 保持不变。

如果不需要返回指针：输入时， RouteInfo 为 NULL。

[out] DestAddress

如果必须返回指针：输入时， DestAddress 是指向 NULL 的指针。 在输出时， DestAddress 接收指向目标 RTM_NET_ADDRESS 结构的指针;否则， DestAddress 保持不变。

如果不需要返回指针：输入时， DestAddress 为 NULL。

返回值

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

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

值 含义
ERROR_INVALID_HANDLE
 该句柄无效。
 
 

注解

如果不再需要路由，请通过调用 RtmReleaseRouteInfo 释放它们。

要求

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

另请参阅

RTM_NET_ADDRESS

RTM_ROUTE_INFO

RtmReleaseRouteInfo