RtmReferenceHandles 函数 (rtmv2.h)

RtmReferenceHandles 函数增加了路由管理器用于访问这些对象的一个或多个句柄指向的对象的引用计数。当客户端必须保留句柄但释放与句柄关联的其余信息结构时，客户端应使用此函数。

语法

DWORD RtmReferenceHandles(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumHandles,
  [in] HANDLE            *RtmHandles
);

[in] RtmRegHandle

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

[in] NumHandles

指定 RtmHandles 中的句柄数。

[in] RtmHandles

要增加其引用计数的句柄数组。

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

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

值	含义
ERROR_INVALID_HANDLE	该句柄无效。

在缓存路由表管理器返回的句柄时，客户端必须始终调用此函数。这会通知路由表管理器，在客户端释放句柄之前，它不应销毁句柄引用的对象。

当客户端必须释放句柄时，客户端必须根据句柄的类型调用相应的发布函数。例如，若要释放路由，请调用 RtmReleaseRoutes。