rtmGetRoutePointer 函数 (rtmv2.h)

RtmGetRoutePointer 函数获取指向允许路由所有者读取访问权限的路由的直接指针。

语法

DWORD RtmGetRoutePointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE  RouteHandle,
  [out] PRTM_ROUTE_INFO   *RoutePointer
);

[in] RtmRegHandle

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

[in] RouteHandle

路由的句柄。

[out] RoutePointer

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

在输出时， RoutePointer 接收指向路由的指针。

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

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

值	含义
ERROR_ACCESS_DENIED	调用客户端不拥有此路由。
ERROR_INVALID_HANDLE	该句柄无效。

返回的指针指向路由的公共部分。