管理句柄

路由表管理器维护其维护的所有信息的引用计数。 这可以防止路由表管理器将任何已释放的内存句柄返回到客户端。 每次将句柄作为显式句柄或信息结构的一部分（例如 RTM_DEST_INFO）返回到调用方时，对应于句柄的 对象的引用计数都会递增。 释放句柄或信息结构时，相应的引用计数将递减。 当引用计数变为零时，将释放 对象。

RtmGetDestInfo、RtmGetEntityInfo、RtmGetRouteInfo 和 RtmGetNextHopInfo 函数返回信息结构。 这些函数分别对应于 RtmReleaseDestInfo、 RtmReleaseEntityInfo、 RtmReleaseRouteInfo 和 RtmRelaseNextHopInfo 函数。

注意

RtmReleaseChangedDests 函数应用于释放由调用 RtmGetChangedDests 返回的句柄。 不要对更改的目标结构使用 RtmReleaseDests 。

 

如果客户端在释放其余句柄时必须在信息结构中保留特定句柄，则客户端可以在释放信息结构之前使用该句柄调用 RtmReferenceHandles 。 然后，可以通过调用 RtmReleaseDestInfo、RtmReleaseEntityInfo、RtmReleaseRouteInfo 和 RtmRelaseNextHopInfo 函数释放该句柄。